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SECTION 1 
CONTENTS OF THE SYSERR LOG 



DESCRIPTION OF LOG 

The syserr log contains all messages that are printed on the operator console by 
Multics and the storage system salvager. There are also messages of the same class that 
are not printed on the operator console. Tools that exist to peruse and print the 
contents of this log are described in Section 2. 

The syserr log is located in a special area of disk storage that is specified to the * 
system via a PART LOG configuration card. Refer to the MOH for more information 
concerning the PART LOG configuration card. 

The general format of the syserr log consists of a header followed by a list of 
threaded messages. The format of individual messages in the log is described below. 

MESSAGE FORMAT 

A syserr message consists of the following components: 

sequence number 

A number that is increased by one for each syserr message. This 
generally serves to number the messages, but sequence numbers may 
be missing, or they may restart at at any point in the log. 



time 



code 



text 



The date and time when the message was logged. 



This is a combined sorting class and action code. The low-order 
decimal digit is the syserr action code. The high-order digits are the 
sorting class. Both are explained below. 



This is the text of the message. 



binary data 

An optional field that is used by some error messages to log more 
detailed information about the cause of the error than could be 
explained in the text. 
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The syserr action codes (the low-order digit of the code above) represent the 
action that was taken at the time the message occurred. These are summarized below. 

print message on console, and log it. 

1 ring alarm, print message on console, and cnish system. {Since the system 
crashes immediately, these messages do not generally find their way into 
the log.) 

2 ring alarm, print message on console, log it, and terminate the process 
issuing the message. 

3 ring alarm, print message on console, and log it. 

4 log message only, but print it if there is no room in the wired syserr 
buffer. 

5 log message only, but discard it if there is no room in the wired syserr 
buffer. 

6-9 not used. 

The syserr sort codes are used to indicate special classes of messages. Almost all 
messages currently fall into class 0, including all hardware-related messages. 

EXAMPLE OF LOG CONTENTS 

The following is a sample of the syserr log contents as it would be printed by 
print_syserr_log, or daily _syserr_process. (See Section 2 for an explanation of these 
commands.) 
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Sat 

1310, 

1313 

1313. 

1313. 

1313 

13H' 

1421, 



Oi./2V76 
.8 3^548 
.2 3^549 
.7 34550 
.7 34551 



1421.0 



1421.0 



1421, 
1430, 
1430, 
1430. 
1430, 

1431 , 
1432, 



34552 
34553 
34554 

34555 
34556 

34557 
34558 

34559 
34560 
34561 

34562 
34563 



1432.6 34564 4 



(est) 
added memory e 
added cpu b 
RCP: Attached tape_06 for Dumper .SysDaemon.z 

3 RCP: Mount Reel 50202 without ring on tape_06 

for Dumper . SysDaemon.z 

4 RCP: Assigned tape_06 to Dumper . SysDaemon.z 

RCP: Detached tape_06 from Dumper .SysDaemon.z 
disk_control : dev attention for dskb 4 

(iom 1 Chan 35) cmd 25 stat 422000000100 
disk_contro1 : dskb 4 sect=317740 cyl=2l4 hd=l 

addr=10120 
di sk_control : dskb 4 detailed status = 
40 00 00 00 81 00 00 00 00 
di sk_control : dskb 4 requires intervention 
RCP: Assigned tape_02 to Fred.AvgUser .m 
RCP: Attached tape_02 for Fred. AvgUser .m 
RCP: Note (tape_02) - 50202, den=l600 
RCP: Mount Reel 50202 with ring on tape_02 for 

Fred.AvgUser .m 
RCP: Detached tape_02 from Fred.AvgUser .m 
hardware fault: parity fault on CPU C by 

Herbie.SysMai nt 
mos_memory .check: EDAC error on mem c 



3 
4 


3 






+--> Text of message. 



H — > syserr code. 
+-> sequence number . 



+--> Time message logged, 



DESCRIPTION OF HARDWARE ERROR MESSAGES 

For convenience, the conventions listed below are used in the error messages 
shovi'n in the following paragraphs. 

D represents a decimal number 
N represents an octal number 
W represents a full word, in octal 
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I/O Errors 

I/O errors are logged in several different ways, depending on the device. They 
are classified here into several groups. Each is explained in separate paragraphs. 

1. User devices. This group includes all unit record devices (printers, readers, 
punches), all tape drives, and I/O disks (disks not used by the storage 
system). 

2. Storage system disks. 

3. The operator console. 

4. The input/ output multiplexer (lOM). 

I/O Errors for User Devices 

Errors for these devices are indicated by a message (as printed by print_syserr_log 
with the -expand control argument) of the following format: 

ioi_interrupt: I/O error. iom=Nl chan-N2 device=N3 status=W 

where: 

1. Nl is the lOM number. 

2. N2 is the channel number. 

3. N3 is the device number 

4. W is the first lOM status word. 

Additional messages that occur each time a user device is attached also appear in 
the log. For example: 

RCP: Errors (dev) = n. 

where: 

1. dev is the name of the device just detached. 

2. n is the number of errors that occurred during the attachment. 

It should be noted, however, that this error count is generated by a user ring program 
that may or may not count errors, and if it does count them, may or may not count 
them correctly. 

See Section 2 for a description of the io_error_summary command, which scans 
the log and summarizes I/O errors. 
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Disk Errors 

Errors encountered by operation of the storage system on disks result in messages 
in the following formats: 

disk_control: Queuing error 

an internal coding error is given. 

disk_control: Reconnected DSKX_NN (iom X chn YY) 

where "DSKX_NN" is the disk subsystem name, such as "dska"; "NN" is the 
drive number, in decimal; "X" is the IOM number, in octal; and "YY" is the 
channel number, in octal. A disk interrupt was apparently lost. Status for the 
disk did not arrive within the expected time. The system restarts the disk 
operation. 

disk_control: Placing DSKX_NN in operation 

a special interrupt has been received for a disk drive marked as broken. The 
system attempts to use the device. 

disk_control: Unexpected IOM status SSSS for DSKX_NN (iom X chn YY) 

status has been received from a channel that was not marked active. This is due 
to a disk subsystem or IOM problem, or to a logic error in the supervisor. The 
system ignores the status and attempts to continue operation. See the Hardware 
and Software Formats, PLM manual (Order No. AN87) for an interpretation of 
the SSSS status. 

disk_control: DSKX_NN now operational 

a disk drive that required intervention has successsfully completed an I/O 
operation. The system again uses its contents. 

disk_control: DSKX_NN requires intervention 

a disk error has occurred that could have been caused by the pack or drive 
being broken or requiring operator attention. The system has retried the 
operation several times without success. The system will try the device 
periodically to check if it has been repaired. 

disk_control: MAJOR_STAT SUBSTAT for DSKX.NN (iom X chn YY) 

where "STAT" is the name of major status and substatus, in character form, 
such as "dev attention." A disk error has occurred on drive DSKX_NN. The 
major status and substatus are interpreted as character strings. The disk address 
is given both as a Multics record address in octal (RRRR) and as an absolute 
sector number in octal (SSSS). The main store address being used was AAAA. 
The hexadecimal value of the detailed status is given in cases where this data is 
useful. See the Hardware and Software Formats, PLM manual (Order No. 
AN87) for an interpretation of this information. 

disk_control: Removing channel YY on IOM X 

errors occurred are indicative of a defective disk channel or MPC. The channel 
receiving the errors is placed offline. 
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Operator Console Errors 

Errors encountered in operation of the operator console result in a message in the 
following format: 



ocdcm_ (log_console_error): i/o error status - Wl flags = W2 



where: 



1. Wl is the lOM status word. 

2. W2 is a word of software flags. The flags and switches with the 

specified meanings are 

this entry is in use 

this is the bootload console 

console is alternate 

console is inoperative 

console is an lOI usable device 

console change has occurred 

prompt for input 

use PCWs instead of IDCWs 

I/O op is in progress 

RE(TURN QUEST) key was hit 

operator has hit request key 

suspend output 



fO active 


ON -> 


fl bootload_console 


ON -> 


f2 alternate 


ON => 


f3 inop_device 


ON -> 


f4 io_device 


ON => 


f5 config_change 


ON => 


f6 prompt 


ON -> 


f7 pcwjo 


ON -> 


f8 io_in_progress 


ON -> 


f9 got_special_int 


ON => 


flO oper_request 


ON -> 


fll break 


ON -> 



Input/Output Multiplexer Errors 

General 'input/outpui multiplexer (lOM) errors result in a message in the 
following format: 

iom_manager: system fault status W. 

where W is an lOM system fault word. 

If an I/O operation fails to complete within a reasonable time interval, a message in 
the following format is printed: 



where: 



ioi^timer: Timeout on lOM Nl, chan N2. dev N3 

1. Nl is the lOM number. 

2. N2 is the channel on which the timeout occurred. 

3. N3 is the device that was connected when the timeout occurred. 
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Main Memory or CPU Errors 

Errors in the operation of the CPU that result in parity, op-not-complete, 
shutdown, or startup faults result in messages that have the format 

hardware_fault: FFF fault on CPU TAG by Userjd path 

where: 

1. FFF 

is a fault name. 

2. TAG 

is the tag of the CPU on which the fault occurred. The value of TAG can be 
the letters a through h. 

3. Userjd 

is the name of the user whose process took the fault. 

4. path 

is the pathname of the procedure in which the fault was taken. 

Machine conditions and history registers are logged in the binary portion of the 
message. A sample printout of the parity fault, as would be provided by using the 
-expand control argument of print_syserr_log or daily_syserr_process, follows: 
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Fri 05/05/83 
1555.2 7^663 
Jones. f^ul ticsc 
Pointer 



(edt) 

harclware_faul t: parity fault on CPU C 
a in >user_dir_cli r_>Mul tics>Jones>mydoc. 
Regi sters; 



by 



013760000000 0001164000U3 
000000000000 000072i*OOOlt3 
034424000000 000253400043 
013460000000 000244400043 

013644 000000 000004 000007 

q: 000000000000 e:000 t: 



000244400043 

000330400043 

000253400043 

000244400043 

xO-7: 012222 

a: 000000000000 

SCU data: 

400350170041 000003150023 400330000200 

000006401200 000000000000 200000757100 

Fault Register: 013000006400 

EIA Info: 

000400000000 000400000000 

000024000000 000077777774 

OU History Reg Data: 

757000757300 177777000005 

177777000005 

177777000005 

177777000005 

177777000005 

177777000005 

177777000005 

177777000005 



000024000000 
003711000000 
034424000000 
000000000000 

000000 000016 000571 

413500100 ralr: 



757000757300 
757000757300 
757000757300 
757000757300 
757000757300 
757000757300 
757000757300 



004314000000 
004116000004 

237000237100 
237000237100 
237000237100 
237000237100 
237000237100 
237000237100 
237000237100 
757000757000 



CU History Reg DATA: 
200007011000 000000042011 



200127011000 
600137757100 
201037710000 
200127237100 
600137011000 
20000701 1000 
200127757100 



000000002201 
000006042200 
000001042201 
000000042011 
000004042201 
000000042202 
000000242041 



DU History Reg DATA: 
777757037717 744243410015 



737757037737 
737757037717 
777757037737 
737757037717 
737757037737 
777757037717 
737757037737 
APU History 



71*4242410015 
7ltl»2434l0015 
744243410015 
744243410015 
744243410015 
744243210015 
744243410015 
Reg Data: 



600137011000 
200007011000 
200127757100 
600137237100 
200007011000 
200127011000 
600137757100 
201005710000 

777757037737 
777757037737 
777757037737 
777757037737 
777757037737 
777757037737 
777757037737 
777757037737 



000000000000 
000007000000 



000077777774 
000000000077 

123777000001 
123777000001 
123777000001 
123777000001 
123777000001 
123777000001 
123777000001 
037777000006 

000004042201 
000000042202 
000000242041 
000002042200 
000000042011 
000000002201 
000006042200 
000122010002 

744242410015 

744243410015 
744243410015 

744243410015 
744243410015 
744243410015 
744243410015 
744243410015 



003302007252 
003506007150 
003506007150 
003302007252 
003506007150 



004160004775 
004060064775 
004060014775 



003506007150 004060044775 
003302007252 004160004775 
003506007150 004060024775 
004160004775 003506007150 004060044775 
004060014775 003506007150 004060024775 
003506007150 004060014775 003506007150 004060024775 
003506007150 004060014775 003506007150 004060024775 



The other three faults are handled in a similar manner. 
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MOS Memory EDAC Errors 

An EDAC error on a MOS memory is logged with a message (as printed by 
print_syserr_log with the -expand control argument) in the following format: 

mos_memory_check: EDAC error on mem M MOS S chip. Error: board B. 
chip C 

where: 

1. M is the tag of the SC containing the bad memory where M is a letter 

from a to h. The error is in the store unit containing the first 
address in this SC. 

2. S is the chip size, Ik or 4k. 

3. B is the number of the board containing the bad chip. 

4. C is the number of the bad chip on board B. 

DATANET 6600 Front-End Network Processor (FNP) Errors 

Certain errors in the operation of the DATANET 6600 Front-End Network 
Processor result in messages in the following formats: 



3 system_control_: A is hung up 
3 system_control_: A error W 



where: 



1. A is a device name of a terminal channel controlled by the message 

coordinator. 

2. W is an error table code. 



Console Messages from FNP 

Certain error conditions in the FNP cause messages to appear on the Multics 
operator console. Most of these conditions are sufficiently serious to cause the FNP to 
crash and generate a dump. 

The general format of a crash message from the FNP is as follows: 

emergency interrupt from 355 TAG: FAULT 
355 instruction counter = IC 

where: 

1. TAG identifies the FNP that crashed. 

2. FAULT is the name of the fault that occurred in the FNP. 
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3. IC is the value of the FNP instruction counter at the time of the 

fault. 

If the fault is "illegal opcode," there is usually an additional message of the form 

module: message 

where module is the name of the FNP program that detected the error, and message 
indicates the nature of the error. 

A few of the FNP error messages indicate probable hardware problems, and 
should be referred to Honeywell Field Engineering if they occur frequently; these 
messages are listed below. Any other FNP messages indicate probable software 
problems. 

unrecoverable i/o error 

more than 5 consecutive i/o errors 

3 consecutive mailbox checksum errors 

receive transfer timing error 

xmit transfer timing error 

send transfer timing error 

In addition, if the fault identified on the first line of the message is "memory 
parity" or "iom chan fault," there is probably an FNP hardware problem. In the latter 
case, the message giving the FNP instruction counter is replaced by a message of the 
form 

channel NN, fault status = XXXXXX 

where NN is a two-digit decimal number, and XXXXXX is a six-digit ocul number. 

The following FNP errors do not crash the system; all of them indicate possible 
hardware problems. 

355 iom channel fault, channel NN, fault status XXXXXX 

dia i/o error, status XXXXXX 

abnormal Isla status XXXXXX 

excessive hsla interrupts, line NN 

trouble synchronizing Isla NN. some lines may not answer. 
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SECTION 2 
COMMANDS 



This section contains descriptions of those Multics commands (including the ones 
that extract the contents of the syserr log) that are useful for diagnosing system 
malfunctions. Each description contains the name of the command (with its abbreviation, 
if any), discusses its purpose, shows the correct usage, lists the arguments that can be 
used, and provides notes and, when necessary, examples. 

Syntax lines give the order of required and optional arguments accepted by a command 
or active function. Optional portions of syntax are enclosed in braces ({}). The syntax 
of active functions is always shown enclosed in brackets ( [] ), which are required for 
active function use. To indicate that a command accepts more than one of a specific 
argument, an "s" is added to the argument name (e.g., paths, {paths}, {-controLargs} ). 
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analyze.multics analyze.multics 



Name: analyze multics, azm 

SYNTAX AS A COMMAND 

azm {-control_args} 

FUNCT/ON 

invokes a subsystem that aids in system crash analysis. It can analyze dumps created by 
the BOS FDUMP command and copied into the Multics hierarchy by the copy_dump 
command. 

CONTROL ARGUMENTS 

-abbrev, -ab 

enables abbreviation expansion of request lines. 

-no_abbrev, -nab 

does not enable abbreviation expansion of request lines. (Default) 

-no_prompt 

suppresses the prompt for request lines in the request loop. 

-no_start_up, -nsu 

does not execute any startup exec_com. (Default) 

-profile PATH, -pf PATH 

specifies the pathname of the profile to use for abbreviation expansion. The suffix 
"profile" is added if necessary. This control argument implies -abbrev. 

-prompt STR 

sets the request loop prompt to STR. The default is the ioa_ STR: 

Vazm'^L (M)-^]:^2x 

-request STR, -rq STR 

executes STR as an azm request line before entering the request loop. 

-start_up. -su 

executes the exec_com "stan_up.azmec" upon invocation of azm. This start_up 
exec_com is first searched for in your home directory, then in your project 
directory (>udd>Project_id), and last in >site. The first exec_com found is used. 

-quit 

exits azm after execution of other arguments. Can be used with -request. 

NOTES 

This command uses the standard search list mechanism to locate FDUMPs. If it does 
not find a "dumps" search list, it creates one, placing >dumps in the search list as the 
default. If additional search paths are desired, the add„search_path command can be 
used to define them. 
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VIRTUAL ADDRESS CONSTRUCTS 

Accessing data requires some pointer value to define an address space. The generation 
of the pointer value is performed by resolving a virtual address (VIRTUAL-ADDR). A 
VIRTUAL-ADDR consist of two parts: a segment number and a word offset. 

The command resolves VIRTUAL-ADDRs from the following types of information: 

Symbol: 

is a symbolic name for a segment number and an offset that can be 
resolved by data in definitions, (i.e., sstSptl can be resolved to the 
correct segment number and offset of the page table lock). 

Segment name: 

a segment name can be resolved in many ways, but it can only provide 
one part of the virtual address; azm uses as the default offset for this 
pointer value (i.e., tc_data is resolved to SEGNO |0). 

Segment number: 

a segment number needs no resolution, but a default action needs to be 
taken for the offset (the default is 0, i.e., SEGNO |0). 

Segment name/number and offset: 

the VIRTUAL-ADDR in this case can be a segment name or segment 
number and an octal offset (i.e., the construct of pds|20 is translated to 
SEGNO 1 20 or dseg|5 is 0|5). The notation "|" and "$" must be used 
without spaces (e.g., 244 10 or sstScmp). 

Temporary pointers: 

azm keeps a set of 11 temporary pointers per translation. A translation 
is one complete entity such as an "FDUMP". These pointers can be set 
with the set request (e.g., set sp 230 1 100). They can be referenced by 
other requests as another type of "symbol" in a VIRTUAL-ADDR 
expression, after they have been set. If not set, these pointers are null. 

Offset operators: 

the operators "+N" and "-N" immediately preceding an octal number, or 
VIRTUAL-ADDR construct can be used to alter the offset of a virtual 
address. N is a number interpreted in octal. No spaces are allowed 
between the operator and the N. For example, sst$ptl +30 are resolved 
to be the SEGNO for sst_seg with the offset of ptl plus 30 octal 
locations; sst$ptl+30 is also valid. 
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Indirection: 

A VIRTUAL-ADDR can imply indirection. The indirect word can be 
used as an ITS pair if it is a valid ITS word pair; if not, the upper half 
of the word is used. The following VIRTUAL-ADDR construct is used 
to specify indirection (sstScmp,*). The format of an indirect pointer 
value is 

segnojof f set.ft segnamejof f set,^< symbol,* 
tenip_ptr,ft temp_ptr |of f set,* 

EXAMPLES OF INDIRECTION 

17|230,* sst|230,* sst$cmp,*+2 
sp,* spl230,ft 

ANALYZE_MULTICS REQUESTS 

absolute address, absadr 

SYNTAX 

absadr VIRTUAL-ADDR 

SYNTAX AS AN ACTIVE REQUEST 

[absadr VIRTUAL-ADDR] 

FUNCTION 

translates a "virtual address" to an absolute memory address. 

ARGUMENTS 

VIRTUAL-ADDR 

can be a segment number, name, or symbolic address (e.g., 64, prds, prds$am_data). 
See "Virtual Address Constructs" above. 

Active request example 

! display_absolute [absadr sst$cmp] 2 

displays the first two words of the absolute address of sst$cmp. 
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add request table, arqt 

SYNTAX 

arqt PATH 

FUNCTION 

adds a user-defined request table in the list of request tables being searched by the 
current azm invocation. 

ARGUMENTS 

PATH 

is the pathname of the request table to be added. This request table must be 
consistent for use with the subsystem utility. (See Section 4 of the Programmer's 
Reference Manual for request table structure.) 

apply, ap 

SYNTAX 

ap VIRTUAL-ADDR {RANGE} command_) i ne 

fUNCT/ON 

extracts all or part of a segment, specified by VIRTUAL-ADDR from the selected 
FDUMP, and places a copy in a temporary segment. This pathname is passed as the 
last argument in the command_line. 

ARGUMENTS 

VIRTUAL-ADDR 

may be a segment number, name or symbolic address {e.g., 64, prds, prds$am_data). 
See "Virtual Address Constructs" above. 

RANGE 

specifies the number of words in octal to be copied. The default is the entire 
segment. 

command_line 

is any command. 
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NOTES 

The offset in the virtual address specifies where the copying of the segment begins. 
When only part of a segment is extracted, it goes at the beginning of the temporary 
segment. For example: 

ap pds$am_data itOO dump_segment 
puts 256 (decimal) words at the beginning of the segment. 

apte 

SYNTAX 

apte {PROC_INDICATOR} {-control_args} 
FUNCT/ON 

displays active page table (apte) information for processes in an FDUMP that match the 
states specified. 

ARGUMENTS 

PROC_INDICATOR 

used for specifying individual processes. It can take one of three forms: 

- The decimal index (starting at zero) of a process in 
the FDUMP. 

- The octal apte offset of the process. 

- The octal process_id of the process. 

CONTROL ARGUMENTS 

-all, -a 

displays apte information for all processes in any state. (Default) 

-blocked, -blk 

displays apte information for all processes in the blocked state. 

-count, -ct 

specifies the total number of processes meeting the criteria specified by control_args. 
With -all, it gives the counts of each process state. 

-current, -cur 

displays apte information for the current process. 

-page_tbl_lock, -ptl 

displays apte information for all processes marked as page table locking. 
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-ready, -rdy 

displays apte information for all processes in the ready state. 

-run 

displays apte information for all processes in the running state. 

-stopped, -stop 

displays apte information for all processes in the stopped state. 

-wait 

displays active page table entry (apte) information for all processes in the waiting 
state. 

EXAMPLES 

apte 2 

displays information for process 2 in the FDUMP. 

apte 10600 

displays information for the process with apte offset 10600 (octal). 

apte 3500555555 

displays information for the process with octal process_id 003500555555. 

associative memory, am 

SYNTAX 

am {-control_args} 

FUNCTION 

displays SDW and/or PTW associative memories. 

LOCATION CONTROL ARGUMENTS 

-dump 

displays the "dump" associative memories from the BOS CPU at the time the dump 
was taken. (Default) 

-prds 

displays associative memories that have been stored in the prds of the processor on 
which the current process is running. 
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CONTROL ARGUMENTS 

-all, -a 

displays all entries in the associative memories. The default is to display only those 
entries that are valid (i.e., the full bit is on). 

-ptw 

displays only the PTW associative memories. 

-pageno PAGENO 

displays only those entries in the PTW associative memories that have a page 
number that matches the value of PAGENO (which is an octal page number). 

-sdw 

displays only the SDW associative memories. 

-segno SEGNO 

displays only those entries in the SDW and PTW associative memories that have a 
segment number that matches the value of SEGNO, which is an octal segment 
number. (See assoc_mem.incl.pll.) 

NOTES 

If no control arguments are given, both the SDW and PTW associative memories are 
displayed for the "dump" associative memories. 



aste 
SYNTAX 

aste segno/segname {-control_args} 

FUNCTION 

displays active segment table (ast), page table, and trailer information. The default 
displays active segment table entry (aste) and page table information only. 

ARGUMENTS 

segno/segname 

is the segment number or segment name of interest. 

CONTROL ARGUMENTS 

-aste 

displays active segment table information for the selected entry. 

-at offset, -at virtual-addr 

displays aste information starting at the offset or virtual address specified. 
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-brief, -bf 

displays everything excluding the page table information. 

-long, -Ig 

displays everything, that is, the asie, page table, and trailer information. 

-page_table, -pt 

displays page table information for the selected segment. 

-trailer, -tr 

displays trailer information about the selected segment. 

configuration deck, cd 

SYNTAX 

cd {card_naines} {-control_args} 

FUNCTION 

displays the contents of the configuration deck in the selected FDUMP. This request 
works exactly like the standard pcd command, except that it gets the configuration deck 
from the FDUMP. 

ARGUMENTS 

card_names 

are the names of the particular configuration cards to be displayed. Up to 32 card 
names can be specified (separated by spaces). If no card names are given, the the 
complete configuration deck is printed. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the error message v^rhen a requested card name is not found. (Default) 

-exclude FIELD_SPECIFIERS. -ex FIELD_SPECIFIERS 

excludes particular cards or card types from being displayed. One to 14 field 
specifiers can be supplied with each -exclude, and up to 16 -exclude control 
arguments can be specified. To be eligible for exclusion, a card must contain fields 
that match all field specifiers supplied with any -exclude argument. 

-long, -Ig 

prints an error message when a requested card name is not found. 

-match FIELD_SPECIFIERS 

selects particular cards or card types to be displayed. One to 14 field specifiers 
can be supplied with each -match, and up to 16 -match control arguments can be 
specified. To be eligible for selection, a card must contain fields that match all 
field specifiers supplied with any -match argument. 
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NOTES 

Field specifiers can consist of a complete card field or a partial field and an asterisk 
(*). An asterisk matches any part of any field. Specifiers for numeric fields can be 
given in octal or decimal, but if decimal they must contain a decimal point. Asterisks 
cannot be specified in numeric field specifiers. All numeric field specifiers are 
converted to decimal and matched against numeric card fields, which are also converted 
to decimal. Hence, the field specifier "1024." matches a card containing the octal field 
2000, and the field specifier "1000" matches a card containing the decimal field 512. 
Note that all card names must be specified before the first -match or -exclude 
argument. Field specifiers following a -match or -exclude argument include all 
arguments until the next -match or -exclude argument. 

display, d 

SYNTAX 

d VIRTUAL-ADDR {EXP} {RANGE} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[d VIRTUAL-ADDR {EXP} {RANGE} {-control_args}] 

FUNCTION 

displays a selected portion of a segment in the FDUMP.. 

ARGUMENTS 

VIRTUAL-ADDR 

specifies the initial offset of the virtual address space to be dumped. May be a 
segment number, name, or symbolic address (e.g., 64, prds, prds$am_data). See 
"Virtual Address Constructs" above. 

EXP 

is an expression, which is either an octal value or a VIRTUAL-ADDR construct 
yielding an octal value. This value can be positive or negative, specified by the 
plus or minus sign. 

RANGE 

specifies the number of words to be dumped in octal. If a RANGE is not 
specified, the default action is to display one word. If the data is an ITS pair, 
two words are displayed. 

MODE SPECIFICATIONS 

-character, -ch, -ascii 

displays the selected number of characters in ASCII. Characters that cannot be 
printed are represented as periods. Usage as an active request is not allowed. 
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-instruction, -inst 

displays the selected number of words as instructions. Usage as an active request is 
not allowed. 

-octal, -oc 

displays the selected number of characters in octal. When used as an active 
request, it returns the octal value of the requested address. (Default) 

-ptr, -p 

displays the selected number of word pairs as pointers. When used as an active 
request, it returns the octal value of the form SEGNO | OFFSET. 

-pptr, -pp 

displays the selected number of words as a packed pointer. When used as an active 
request, it returns the octal value of the form SEGNO | OFFSET. 

-pptrx, -ppx 

displays the selected number of words as packed pointers and expands the 
SEGNO I OFFSET to a segment name. Usage as an active request is not allowed. 

-ptrx, -px 

displays the selected number of word pairs as pointers and expands the SEGNO | OFFSET 
to a segment name. Usage as an active request is not allowed. 

CONTROL ARGUMENTS 

-as STRUCTURE_NAME 

displays the data as a hardcore PL/ 1 structure defined by STRUCTURE_NAME. 
The STRUCTURE_NAME is a hardcore system-defined include file. The address 
given in the display request is taken as the address of the beginning of the 
structure. If the whole structure is being displayed, that is the address where 
display begins. If only certain elements are being displayed, that is the address 
used to compute offsets of the elements. The structure reference following -as 
must be a single string, containing no spaces, and follows the syntax described 
below. The single string is used to specify structure elements, array indexes, and 
substring matching. Usage as an active request is not allowed. 

-long. -Ig 

displays each element of the structure on a separate line. This control argument is 
only implemented with -as. 

STRUCTURE SYNTAX 

The structure reference is made up of two parts: a structure element reference and an 
optional set of match strings. If no match strings are supplied, no siring matching is 
done. The structure element reference syntax consists of one or more element names, 
separated by periods, and may contain subscripts following some of these element 
names. The first name in a structure element reference must be a level-one structure 
reference; partially qualified top-level references are not permitted. Intermediate levels 
of qualification may be omitted as long as there is no ambiguity. 
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All subscripts must be supplied as decimal integers. The subscripts can be cross-section 
references such as "(1:4)" to reference elements one through four. Asterisk bounds 
cannot be used: if a cross section is desired, its upper and lower bounds must be given 
as decimal constants. If an element has more subscripts than are supplied, the complete 
cross section is printed for the remaining subscripts. To eliminate the need for quoting, 
subscripts may be surrounded by braces instead of parentheses. 

In order to specify that only certain elements be displayed (such as all those with 
names containing the string "time"), a set of match strings can be given after the 
structure element reference. Each match string begins with a slash and is followed by 
the string itself. The final match string can be followed by a slash, but this is not 
required. If match strings are specified, any element that matches at least one string is 
displayed. 

EXAMPLES OF STRUCTURE REFERENCES 

pvt 

the whole structure "pvt". 



pvl.n_en tries 

the single element "n_entries" in the structure "pvt" 



sst/time/, sst/time 

any elements in the structure "sst" containing the string "time". Note that the final 
slash is optional. 

sst/ time/ meter/ 

any elements in the structure "sst" containing either the string "time" or the string 
"meter". 

sst.space{3} 

element three of "ssLspace". 

sst.space{2:4} 

elements two, three, and four of "ssLspace". 

sst. space 

all elements of "ssi.space". 

sst.level{l} 

both elements of the "level" array for "sst. level} 1}" 

ssLlevel {1} .ausedp, sst.]evel.ausedp{l} 

the single element "ausedp" of the "level" array for "sst.level{l}" 
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STRUCTURE OUTPUT FORMAT 

The default output format is a compressed form, which places as many values on a line 
as will fit within the line length. The -long control argument places one value on a 
line. The short form, additionally, collects all bit(l) flags and displays them, at the end 
of the display for each substructure or array element, in two groups: one listing all the 
flags that were on ("l"b) and one for all the ones that were off ("0"b). 

All PL/ 1 data types are displayed in the same representations used by probe. 
Additionally, the following special formats are used: 

1. Bit strings are displayed in octal if the length is divisible by three, in hex if 
divisible by four, and as bit strings otherwise. 

2. Character strings are- displayed as a string concatenated with a repeated constant 
if the string is padded on the right with more than 16 nulls, spaces, or octal 
777 characters. 

3. Large-precision (> 51) fixed binary values are also displayed as clock readings if 
their values represent clock readings within 10 years of the present. 

EXAMPLES 

d 75 1 560 2 
displays the two words in seg number 75 starting at offset 560. 

d pdsl560 2 
displays the two words in the segment named pds starting at offset 560. 

d pds$trace 
displays one word in the pds segment beginning at the offset specified by Strace. 

display 2itit|260 +20 k 
displays four words of segment number 244 starting at offset 300 octal. 

d sp 20 

displays 20 octal words starting with the segment offset defined in the azm internal 
temporary pointer (see set request). 
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d sst$cmp,>> +sst$cmesi2e sst$strsi2e 

causes the word at sstScmp to be used as an indirect word, or an indirect pointer if 
the resultant address has ITS modification, to develop the starling virtual address. The 
value derived from sstScmesize is then added to the starting offset for the "final" 
starting address. The range, or number of Vk^ords to be displayed, is specified by the 
value contained in sstSstrsize. 

d sst|2 -as apte 
displays the APTE entry at the given offset in the SST as it is defined by apte.incl.pU. 

display absolute, da 

SYNTAX 

da ABS-ADDR {RANGE} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[da ABS-ADDR {RANGE} {-control_args}] 

FUNCTION 

dumps an absolute memory address space in the FDUMP. 

ARGUMENTS 

ABS-ADDR 

is the starting absolute memory address, in octal. 

RANGE 

specifies the number of words to be dumped in octal. If a range is not specified, 
the default is one word. If the data to be dumped is an ITS pair, two words are 
dumped. 

MODE SPECIFICATIONS 

For a description of the mode specifications, see the display request. 

-character, -ch. -ascii 
-instruction, -inst 
-octal, -oc 
-ptr, -p 
-pptr, -pp 
-pptrx, -ppx 
-ptrx, -px 



2-14 AR97-03 



analyze_muliics analyze_multics 



events, ev 

SYNTAX 

ev {-controt_args} 

FUNCTION 

displays significant events, in reverse chronological order, from an FDUMP (see 
"Notes"). 

CONTROL ARGUMENTS 

-last N, -It N 

specifies the number of events to print. The default is to print all. 

-long, -Ig 

displays disk queue events. 

-time NSECS, -tm NSECS 

specifies the time in seconds before the dump was taken when events were 
significant. The default is 10 seconds. 

NOTES 

The following events are considered as significant: machine conditions (from BOS, prds, 
pds,' and the mc_trace_buf), traffic control state change time, Syserr messages (from 
both syserr_data and syserr_log), Fim frames in any stack, and connects by device and 
disk queues (long report only). 

history _regs, hregs 

SYNTAX 

hregs {HREGS_spec i f ier} {-control_args} 

FUNCTION 

displays a composite analysis or octal dump of the processor history registers. This 
request is useful for people who are knowledgable of the hardware. The default action 
is to display the AU, CU, DU, and OU history registers for the pds in a threaded 
order and interpreted format. 

HREGS SPECIFIERS 

-condition VIRTUAL-ADDR, -cond VIRTUAL-ADDR 

displays history registers from a condition frame, the location of which is described 
by VIRTUAL-ADDR. 
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-dump 

displays the "dump" history registers from the BOS CPU at the time the dump was 
taken. 

-pds 

displays the history registers that have been stored in the current processes pds. 
(Default) 

VIRTU AL-ADDR 

displays the history registers that have been stored at the address space specified by 
VIRTU AL-ADDR. 

CONTROL ARGUMENTS 

-au 

displays the AU history registers only. 

-cu 

displays the CU history registers only. 

-du 

displays the DU history registers only. 

-ou 

specifies that only the OU history registers are to be displayed. 

-interpret 

displays the interpreted form of the history registers only (default), or, if -octal is 
given, include the octal representation also. 

-octal, -oc 

displays the octal values of history registers only, or, if -interpret is also selected, 
display octal and interpreted form. If neither -octal nor -interpret is specified, the 
default action is to display the interpreted form only. 

-thread 

displays the selected history registers in the "correct" order. (Default) 

-no_thread 

display the selected history registers in serial order, without attempting to sort 
them. 



2-16 AR97-03 



analyze_multics analyze_multics 



list dumps, Isd 

SYNTAX 

Isd {PATH} 

FUNCTION 

lists the FDUMPs in the selected dump directory. If PATH is not given, FDUMPs 
from all the dump directories specified in the dumps search list are listed. 

ARGUMENTS 

PATH 

is the pathname of the dump directory to be listed. 

list processes, Isp 

SYNTAX 

Isp {PROC_INDICATOR} {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[Isp {PROC_INDICATOR} {-control_args}] 

FUNCTION 

lists all known processes in the selected FDUMP. As an active request, it returns the 
process_ids meeting the control argument criteria. 

ARGUMENTS 

PR0C_IND1CAT0R 

used for specifying individual processes. It can take one of three forms: 

- The decimal index (starting at zero) of a process 
in the FDUMP. 

- The octal apte offset of the process. 

- The octal process_id of the process. 
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CONTROL ARGUMENTS 

-all. -a 

lists all processes in the FDUMP. (Default) 

-blocked, -blk 

lists processes marked as blocked. 

-count, -ct 

counts all processes. With -all, it gives the counts of each process state. 

-current, -cur 

lists the current process. 

-page_tbl_lock, -ptl 

lists processes marked as page table locking. 

-ready, -rdy 

lists processes marked as ready. 

-run 

lists processes marked as running. 

-stopped, -stop 

lists processes marked as stopped. 

-wait 

lists processes marked as waiting. 

EXAMPLES 

! do "select_process &l;sdw 0" ([1 i st_processes]) 

displays the SDW for DSEG for all processes in the FDUMP. 

machine conditions, me 

SYNTAX 

mc {MC_specif ier} {-control_args} 

FUNCTION 

displays all or parts c^ machine conditions based on the given pointer. 

MC SPECIFIERS 

-dump 

specifies the dump for the BOS CPU regs at time of dump. 
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-pds {STRl} 

where STRl can be "all", "fim". "page_fault" ("pgf"), "signaller" ("signal", "sig"). It 
defaults to "all" if STRl is not given. 

-prds {STR2} 

where STR2 can be "all", "fim", "interrupt" ("int"), "system_trouble" ("sys"). It 
defaults to "all" if not given. 

VIRTU AL-ADDR 

is the virtual address construct used to define the address space containing machine 
conditions. 

CONTROL ARGUMENTS 

-eis 

displays the EIS pointers and lengths (interpreted). 

-faults, -fit 

displays the fault register. 

-long, -Ig 

displays all elements of the MC. 

-mc_err 

displays the mc_err data word. 

-misc 

displays the miscellaneous data (i.e., mc_err, fault reg, time). 

-octal, -oc 

displays the eis info, scu data, or pointer registers, in octal. This control argument 
is used with -scu, -eis, or -regs. 

-pointers {PR_LIST}. -prs {PR_LIST} 

displays pointer registers selected by PR_LIST (from to 7, separated by spaces). 
If PR_LIST is not specified, all the pointers are displayed. 

-ppr 

displays only the PSR and IC from the MC. 

-registers {REG.LIST} , -regs {REG_LIST} 

displays only the basic OU registers. Where REGS_LIST can be any of the 
following: 

xO xl x2 x3 x4 x5 x6 x7 a q all. 

If REG_LIST is not specified, all of the basic OU registers are displayed. 

-scu 

displays only the scu data of the MC. 
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-time, -tm 

displays the MC time. 

-tpr 

only displays the TSR and the CA from the MC. 

NOTES 

If no MC specifiers are given, the temporary pointer prmc is used. The default control 
arguments are -eis. -fault, -mc_err, -pointers, -scu, -time, and -tpr. Either -pds or 
-prds must be supplied. The machine_conditions request sets all azm-defined temporary 
pointers as seen in the machine_condition frame. 

EXAMPLES 

mc -pds fim -scu 

displays the scu data found in the fim frame of the pds currently being referenced in 
the dump. 



page trace, pgt 

SYNTAX 

pgt {-control_arg} 

FUNCTION 

displays the contents of the page trace table in the current process data segment (PDS). 
The default is to display the last 15 trace entries. Trace entries are always displayed in 
reverse chronological order. 

CONTROL ARGUMENTS 

-all. -a 

displays all trace entries. 

-last N. -It N 

specifies the number of trace entries, where N is a positive decimal integer, to be 
displayed. 

replace, rp 

SYNTAX 

rp segno/segname PATH 
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FUNCTION 

replaces the segment designated by segno/segname in the current translation table with 
another segment designated by PATH. 

ARGUMENTS 

PATH 

is the pathname of the segment. The equal convention can be used' rp 
bound_system_faults [e wd] >=.new 

segno/segname 

the segment number or segment name within the translation table to be replaced. 

NOTES 

Both per-process and per-system segments can be replaced. For example, if the pds is 
replaced in a process, it affects only the current process; whereas if tc_daia is replaced 
in a process, it affects the whole FDUMP. 



scus 

SYNTAX 

scus 
FUNCTION 

prints the memory address space (in octal) of each scu from the registers saved in the 
FDUMP. 

sdw 

SYNTAX 

sdw {segno/name} {segno/name} 

FUNCTION 

displays the SDWs in the current processes DSEG. 

ARGUMENTS 

segno /name 

is the segment number or name of interest. The first is the starting segment 
number and the second is the ending segment number. If only one is given, only 
one is displayed; if none are given, all are displayed. 
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search, srh 

SYNTAX 

srh VIRTUAL-ADDR {RANGE} SEARCH_STR I NG 

SYNTAX AS AN ACTIVE REQUEST 

[srh VIRTUAL-ADDR {RANGE} SEARCH_STR ING] 

FUNCTION 

searches a segment starting at VIRTUAL-ADDR matching on SEARCH_STRING. The 
search is performed on a 36-bit-word boundary. As an active request, the virtual 
addresses matching the criteria specified is returned. 

ARGUMENTS 

VIRTUAL-ADDR 

is the pointer to the address space to search. 

RANGE 

specifies the number of words to be searched from the starting offset, where range 
is an octal value. The default is the rest of segment. The search is started from 
VIRTUAL-ADDR. 

SEARCH_STRING 

is a 12-characteT string representing the 12 octal digits that make up a machine 
word (36 bits. 3 bits per digit). This forms both the search data and search mask 
by using the hyphen (-) as a "don't care character" in the string. The "do care 
digits" are octal "from to 7." Any other character is illegal. 

EXAMPLES 

To search for 

L all words in segment 76 that have the last two digits of 43: 

srh 76 43 

2. all words in tc_data where the upper half = 070707: 

srh tc data 070707 
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3. words that end in 1234 in sst_seg starting at 1000 but only searching for 200 
octal words: 

srh sst_seg|1000 200 1234 

4. words that start with 45 and end with 77 starting a sst_seg$ptl for 100 words: 

srh sst_seg$ptl 100 45 77 

segment name, name 

SYNTAX 

name VIRTUAL-ADDR 

name number 
SYNTAX AS AN ACTIVE REQUEST 
[name VIRTUAL-ADDR] 

[name number] 
FUNCTION 

prints the segment name given a virtual address or a segment number. . 
ARGUMENTS 

VIRTUAL-ADDR 

is the virtual address construct used to define the segment. 

number 

is the segment number of the segment to be referenced. Thus, "name 230" returns 
the name associated with the segment number 230, which is "stack_0". 

segment number, number 

SYNTAX 

number VIRTUAL-ADDR 

number name 
SYNTAX AS AN ACTIVE REQUEST 
[number VIRTUAL-ADDR] 

[number name] 



2-23 AR97-03 



analyze_multics analyze_multics 



FUNCTION 

prints the segment number given either a virtual address or a segment name. 

ARGUMENTS 

VIRTU AL-ADDR 

is the virtual address construct used to define the segment. 

name 

is the name of a segment, e.g., stack_0. Thus, "number sst_seg" returns the 
segment number associated with the segment sst_seg, which is "77". 

select dump, sId 

SYNTAX 

sld {NAME} {-control_args} 

FUNCTION 

selects and translates an FDUMP of a system crash. Found via the dump search list, 
which defaults to >dumps. 

ARGUMENTS 

NAME 

is the ERF number or the path name of the zero component of the FDUMP. It 
can also be the form path>35, where 35 is the erf number. Several control 
arguments are also acceptable if NAME is not specified. 

CONTROL ARGUMENTS 

-first, -ft 

selects the first dump (by erf number) in the dump directory found via the dump 
search list. 

-last, -It 

selects the last (most current) dump in the dump directory according to erf 
number. 

-next, -nx 

selects the next dump in the dump directory. This is relative to the dump 
currently being looked at. 

-previous, -prev 

selects the previous dump in the dump directory. This is relative to the dump 
currently being looked at. 
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select process, sip 

SYNTAX 

sip {PROC_ INDICATOR} {-control_args} 
FUNCTION 

selects a process for examination. When invoked with no arguments, the current process 
is listed. 

ARGUMENTS 

PROC_INDICATOR 

used for specifying individual processes. It can take one of three forms: 

- The decimal index (starting at zero) of a process 
in the FDUMP. 

- The octal apte offset of the process. 

- The octal process_id of the process. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the message about changing processes. 

-cpu TAG 

selects the DBR for the process running on the CPU identified bv TAG (where 
TAG" is one character in the range a through h). 

-dbr dbr_value 

selects the process defined by the dbr_value. 

-long, -Ig 

prints a message announcing the new process selected. (Default) 

set 

SYNTAX 

set PTR_N VIRTUAL-ADDR 
FUNCTION 

sets an internal temporary pointer like a cpu pointer register (i.e., "pr6" or "sp"). These 
pointers can then be used as a VIRTUAL-ADDR by other azm requests. 

ARGUMENTS 

VIRTUAL-ADDR 

can be a segment number, name, or symbolic address (e.g., 64, prds, prds$am_data). 
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PTR_N 

can be either the name or number of a "temporary pointer." 

There are eight temporary pointers and two special-case pointers. 



NUMBER 


NAME 


prO 


ap 


prl 


ab 


pr2 


bp 


pr3 


bb 


prmc 


intended t 


prfr 


intended t 



NUMBER 


NAME 


pr4 


Ip 


pr5 


lb 


pr6 


sp 


pr7 


sb 



intended to be a pointer to the current MCs. 
intended to be a pointer to the current stack frame. 

EXAMPLES 

set pr6 240 1 100 
this sets a temporary ptr named pr6 (sp). 

set sb 240 

this sets the temporary ptr (sb) to the base of seg 240 (24010). 

NOTES 

The value of a temporary pointer can be displayed via the value request: v {ptrn 
-all} 

stack, sk 

SYNTAX 

sk VIRTUAL-ADDR {-control_arguments} 

FUNCTION 

traces a given stack. 

ARGUMENTS 

VIRTUAL-ADDR 

is the virtual address construct defining the stack to be traced. 
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CONTROL ARGUMENTS 

-arguments, -ag 

prints the arguments for the stack frames traced. 

-for N 

traces for N stack frames. If no valid stack frames exist (stack_begin ptr - 
suck_end_ptr), a -force must be used. 

-force, -fc 

forces a forward stack trace. For use when there are no valid frames for this 
stack (stack_begin_ptr = stack_end_ptr). 

-forward, -fwd 

traces in a forward manner. 

-long, -Ig 

prints the arguments and an ocui dump of the stack frames traced. 

NOTES 

The default is to trace the stack in reverse order unless -force or -forward are 
specified. If the VIRTUAL-ADDR has a zero offset, then the trace starts at the offset 
of the first stack (stack_header.stack_begin_ptr). If it has a nonzero offset, then the 
trace is started from that offset in the given stack. 

syserr_log, slog 

SYNTAX 

slog {-control_args} 
FUNCTION 

displays all or parts of the syserr_log and syserr_data segments from the dump It does 
nor examine the perm_syserr_log. The default is to print the entire log. 

CONTROL ARGUMENTS 

-action A 

displays only messages with an action code specified by A, where A is a decimal 
integer in the range to 9. 

-exclude STR -ex STR 

excludes any message that contains STR. where STR is a string that is matched 
against messages in the log. 

-last N, -It N 

starts the scan N messages back from the end of the log, where N is a decimal 
integer. 
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-match STR 

displays any message that contains STR, where STR is a string to be matched 
against messages in the log. 

-expand, -exp 

interprets the binary data of messages. The format is generally dependent on the 
text of the message. 

traffic control queue, tcq 

SYNTAX 

tcq {-contro1_args} 

FUNCTION 

displays process DBR, process state, process ID, current CPU, and user ID from the 
Traffic Controller's Eligible Queue, as well as the "process number" in the FDUMP. 
The default is to display only the eligible queue. 

CONTROL ARGUMENTS 

-all 

displays the eligible, real-time, interactive, and work-class queue entries, including 
the unthreaded entries. 

-ready, -rdy 

displays the eligible, real-time, interactive, and work-class queues, excluding the 
unthreaded entries. 



value, V 

SYNTAX 

V PTR_Ni ...PTR_Nn 

V -al 1 
FUNCTION 
displays the current value of one or all of the temporary pointers. 
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ARGUMENTS 

PTR_N 

specifies which of the temporary pointers is to be displayed. Refer to the set 
request for a list of the azm-defined pointer names. 

-all, -a 

specifies that all of the pointers are to be displayed. (Default) 

verify_associative_memory, vfam 

SYNTAX 

vfam {-control_args} 

SYNTAX AS AN ACTIVE REQUEST 

[vfam {-control_args}] 

FUNCTION 

performs a consistency check on the associative memories stored at the time of a dump 
by comparing them to the appropriate entries in the "dump dseg" and page tables. 
When used as an active request, returns "true" if any inconsistencies are found, "false" 
otherwise. 

CONTROL ARGUMENTS 

-ptw 

restricts the verification to the PTW associative memories. 

-sdw 

restricts the verification to the SDW associative memories. 

NOTES 

If no argument is given, both SDW and PTW associative memories are checked. 
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why 

SYNTAX 

why 

FUNCTION 

tries lo find the stack that has a call to syserr_real$syserr_real or call_bos$call_bos and 
sets the temporary pointers pr6 and prfr to the stack frame. This request searches the 
stacks for a frame that has a return_to_ring_0_ frame and sets the temporary pointers 
from this set of machine conditions that called this entry. 

NOTES 

If the crash is due to fim_util$check_fault finding a problem, the machine condition 
CU data is displayed and all temporary pointers are set from these machine conditions. 
If this is an execute fault, then some lock info is printed and the process selected is 
locked (look at PTL first then ASTL). 

If this fdump is due to a manual return to BOS, then some pertinent lock info is also 
printed. 

STANDARD SUBSYSTEM REQUESTS 

prints a line describing the current invocation of azm. 

7 

prints a list of requests available in azm. 

abbrev, ab 

controls abbreviation processing of requests lines. 

answer 

pro\'ides preset answers to questions asked by another request. 

do 

executes /returns a request line with argument substitution 

execute, e 

executes a Multics command line. 

exec_com, ec 

executes a file of azm requests that can return a value. 
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help 

prints information about azra requests and other topics. 

if 

conditionally executes/returns one of two request lines. 

list_help, Ih 

displays the name of all azm info segments on given topics. 

list_requests, Ir 

prints a brief description of selected azm requests. 

quit, q 

exits azm. 

ready, rdy 

prints a Multics ready message. 

ready_off. rdf 

disables printing of a ready message after each request line. 

ready_on, rdn 

enables printing of a ready message after each request line. 

subsysiem_name 

prints/ returns the name of this subsystem. 

subsystem_version 

prints/ returns the version number of this subsystem. 

The standard escape convention for executing Multics command lines (..) is also 
supported. 



Name: check cpu speed 

SYNTAX AS A COMMAND 

check_cpu_speed {cpu_tags} 

FUNCTION 

performs a relative check of the speed of a currently running CPU on the system. 
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ARGUMENTS 

cpu_tags 

are the tags of CPUs configured on the system. If more than one is supplied, the 
values must be separated by spaces. The default is to run on all CPUs listed by 
the list_proc_required command that are currently marked as ON in the configuration 
deck. 

ACCESS REQUIRED 

This command requires access to the phcs_ gate to run. 

NOTES 

Your process is left running with the original set of system CPUs. 

The command runs on a CPU outside of your original set of CPUs if the CPU tag is 
given on the command line. 



I 



Name: daily syserr process 

SYNTAX AS A COMMAND 

dai 1 y_syserr_process {-control_arg} n 

FUNCTION 

runs once a day to process the syserr log for the preceding day. It writes out all syserr 
log entries on various I/O switches. 

CONTROL ARGUMENTS 

-from DT 

where DT is a dale/ time acceptable to convert_date_to_binary_ (see the Subroutines 
I manual). 

If the control argument is given, the syserr log is scanned for the first line written 
after the date specified. Log processing starts from this entry. If it is not given, the 
program looks for the sys_admin_data segment in the current working directory and 
uses the log_control structure there to look for information describing the index of the 
last entry previously processed. 
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Distribution of the output is controlled by the control file, syserr_select_file, in the 
current working directory. This file has comment lines beginning with an asterisk (*) 
and selector lines of the form 

switch_name,S.opcode,text 

where: 

1. switch_name 



2. S 



3. opcode 



is the name of the I/O switch on which a line is written. 



is the syserr action code to be considered. See Section 1 for an 
explanation of these codes. S can also be specified as "*" to indicate 
all action codes. 



is the operation code. Valid opcodes are 

all 

selects all lines (at this syserr code) 

any 

selects all lines containing text 

begin 

selects all lines beginning with text 

not 

inhibits all lines not containing text 

nbegin 

inhibits all lines not beginning with text 

count 

counts all lines containing text 

bcount 

counts all lines beginning with text 

allx 

like all, but messages with binary data have the data expanded 
when printed 
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4. text 



anyx 

like any, but messages with binary data have the data expanded 
when printed 

beginx 

like begin, but messages with binary data have the data 
expanded when printed 



is optional text that is the operand of opcode. 



The opcodes not and nbegin must precede any selector lines they are to inhibit for a 
given I/O switch. 

Each entry in the syserr log is considered. For each entry, the selector lines in 
syserr_select_file may or may not select the entry, depending on the operation code. If 
the entry is selected, it is written on the named switch. A syserr log entry can are 
selected (and therefore written) more than once if different switches are named. 

All I/O switches named must be attached and open before daily_syserr_process is 
called. 

At the end of processing, total lines are written. Then, if any lines were selected, a 
total count is printed out. 

NOTES 

This command is intended to be used by the "crank" absentee job run by the system 
administrator every day. This job is controlled by the contents of master.ec contained 
in >udd>SysAdmin>lib. The daily_syserr_process command itself is controlled by the 
syserr_select_file segment contained in >udd>SysAdmin>accounting_library. 

The system administrator and site analysts should be consulted whenever these files must 
be modified so that they are more suitable for an individual installation. 

EXAMPLES 

Included here are excerpts of the files that are used ac a representative Multics site. 
These files cause all hardware-oriented messages for a given day to be printed in the 
segment dai]y_log_l. 
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syserr_select_f i le 



* syserr log control file. 



dai 


iy_' 


dai 


iy_i 


dai 


'y_i 


dai 


iy_i 


da i 


'y_i 


dai 


'y_' 


dai 


'y_i 


dai 


'y_i 


dai 


iy_i 


dai 


iy_i 


dai 


'y_i 


dai 


iy_' 


dai 


iy_i 


dai 


iy_i 


dai 


iy_i 


dai 


'y_i 


dai 


iy_i 


dai 


iy_' 


dai 


'y_i 


dai 


iy_i 



I/O 
I/O 



error 
error 



netwo 
netwo 

it 

'•< END 



Iog_0,5tbcount, ioi_i nterrupt: 

log_0,5.nbegin, ioi_i nterrupt: 

log_0,5't,al 1 

log_0,3,bcount,RCP: Mount Reel 

log_l ,3,bcount,RCP: Mount Reel 

log_l , 1 ,al 1 

log_l ,2,al 1 

log_l ,0,bcount, op-not-complete 

log_l ,0,bcount .par i ty 

log_l ,3,bcount ,pxss: notify time out 

log_l ,0,bcount,on_l i ne_salvager : begin salvagin; 

log_l ,0,bcount, ITT overflow 

log_l ,0,begi n.Now terminating user process 

log_2,3,nbegin,RCP: Mount 

log_2, 3, not, setting timax 

log_2,0, nbegi n.RCP: Detaching 

log_2,0,nbegin,RCP: Force Detaching 

log_2, 5. bcount, ioi_i nterrupt: I/O error. 

log_2,5.nbegin, ioi_interrupt: 

1 og_2 , '•« , a 1 1 
rk_log, >'«,any , imp 
rk_log,'«, any, network 



i/0 error 
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The following excerpt from master.ec shows how the daily log files are attached and 
opened. Then daily_log_process is invoked to fill the files. The files are then closed, 
detached, and dprinied. 



master .ec 



o_cal 

o_cal 

o_ca 1 

o_cal 

o_ca) 

o_cal 

o_cal 

I o_ca 1 

dai ly_; 

i o_ca 1 

i o cal 



attach daily_log_0 vfile_ dai1y_log_0 
attach daily_1og_l vfile_ dai1y_1og_l 
attach daily_log_2 vfile_ daily_log_2 
attach network_log vfile_ network_log 
open daily_log_0 stream_output 
open daily_log_1 stream_output 
open daily_log_2 stream_output 
open network_)og stream_output 
syserr_process 

close (daily_log_0 daily_log_1 daily_log_2 network_log) 
detach (daily_log_0 dany_log_l daily_)og_2 network_log) 



exec_com 
exec_com 
exec_com 
exec_com 
exec com 



util dp (daily_log_2 bwchart .pr i nt) assurance] 2 

utii dp (sumry cutrpt daily_log_0 crank .absout) acctsO 2 

util dp (daily_log_l bwchart .pr i nt) adminO 2 

util dp daily_log_2 sysprg2 

util dp (daily_log_0 bwchart. pr i nt sumry crank .absout) adminl 2 



Name: device meters, dvni 

SYNTAX AS A COMMAND 
device^meters {-control_args} 
FUNCTION 

* prints out metering information for the ptgc control devices. Information can be 
printed for the disk subsysteuK. 
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CONTROL ARGUMENTS 

-error, -er 

prints out error occurrence statistics for the device (see Notes below). 

-reset, -rs 

resets the metering interval to begin with the last call with -reset specified. If 
-reset has never been given in a process, it is equivalent to having been specified 
at system initialization time. 

-left 

prints out information regarding available space on each device. 

-io 

prints I/O volume statistics for each device. 

-latency, -lat 

prints device latency (delay) statistics. 

-report_reset, -rr 

generates a full report and then performs the reset operation. 

NOTES 

If no control argument is given, a full report is generated. 

The following items are printed if -error is specified: 

EDAC Corr. Errs 

is a count of the times a read was performed and an error occurred, but 
the EDAC (error-detection-and-correction) hardware was able to correct 
the error. 

Recov. Errors 

is a count of the times an error occurred and the EDAC hardware was 
unable to correct it, but a subsequent retry resulted in proper transmittal 
of the data. 

Fata] Errors 

is a count of the occurrences of nonrecoverable errors. 
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Name: display cpu error 

SYNTAX AS A COMMAND 

di splay_cpu_error {-control _args} 

FUNCTION 

scans the syserr log and displays machine conditions and history registers. 

CONTROL ARGUMENTS 

-from DT, -fm DT 

starts scanning the log at the date/time given. 

-to DT 

stops scanning the log at the date/ time given. 

-for T 

computes the ending time from the starting time, where T is a relative time (such 
as "Ihour"). 

-cpu CPU_LIST 

displays information for the CPUs specified, where CPU_LIST is a list of CPU 
tags ("a c"). 

-nothread 

specifies that the history registers are not to be threaded. The history registers will 
be output in octal with no interpretation. The default is off. 

-expand, -exp 

specifies that the history registers are not to be threaded but that they are to be 
interpreted. 

NOTES 

If -from DT is not given, the scan starts with the earlies entry in the syserr log. The 
ending lime can be specified by using -for or -to. but not both. If both are omitted, 
the scan terminates with the last entry in the log. All dates and times must be in a 
format acceptable to convert_date_io_binary_ (see the Subroutines manual). 

You must have re access to audit_gate_ and r access to the perm_syserr_log to use this 
command. 
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Name: display, svserr log part 

SYNTAX AS A COMMAND 

display_syserr_log_part {args} 

FUNCTION 

displays portions of the syserr logging partition that exist on the disk, in order to 
diagnose and correct problems that might occur in the syserr logging partition. 

ARGUMENTS 

header, he 

prints the syserr log partition header. 

check D, ck D 

checks message threads in direction specified by D and validates message formats. 
Direction is specified by one of the following: 

forward, f forward checking only 

reverse, r reverse checking only 

message N, msg N 

displays a single message with message header information, message text and 
expanded binary output, and octal message words. The message to be displayed is 
specified by appending a positive or negative integer to the message argument: 

N displays the log message that is N from the top 
-N displays the log message that is N from the last 

CONTROL ARGUMENTS 

-offset ADDR, -ofs ADDR 

displays message at word offset ADDR from the beginning of the syserr log. 

-number N, -nb N 

displays the syserr log message whose message number is N (decimal). 

NOTES 

If no arguments are specified, all logging partition information is displayed. You must 
have re access to >system_library_l>phcs_ in order to use this command. 
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Name: dump firmware 

SYNTAX AS A COMMAND 

dump_f i rmware path mem {addr count} 

FUNCTION 

is used to dump the contents of a segment containing MPC firmware. 

ARGUMENTS 

path 

is the pathname of the segment containing the firmware. 

mem 

must be "cs" to dump the control store overlay, "rw" to dump the read/write 
overlay, or "size" to print the locations and lengths of overlays in the module. If 
this argument is "size," no further arguments need be given; otherwise, the addr 
and count arguments described below must be given. 

addr 

is the starting address to dump, in hexadecimal. This argument must be given if 
the mem argument is not "size." 

count 

is the number of words to dump, in hexadecimal. This argument must be given if 
the mem argument is not "size." 



Name: dump mpc 

SYNTAX AS A COMMAND 

dump_mpc mpc_name {-control_args} 

FUNCTION 

performs a dump of the read /write memory of a MPC and selectively edits the dump, 
the trace table, and MPC and device statistics. 

ARGUMENTS 

mpc_name 

is the name of the MPC to be dumped. This name must appear on an MPC card 
in the config deck. If this argument is omitted, -channel must be given. 
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CONTROL ARGUMENTS 

-dump 

displays a hexadecimal dump. 

-trace 

displays an interpreted trace of the MFC. 

-extend, -ext 

extends the output file if it exists. The default is to overwrite the file. 

-Stat 

displays the MFC and device statistics. 

-mp)c 

displays MFC error data only. 

-channel channel_name, -chn channel_name 

specifies a channel name, where channel_name is of the form [iomteg] [channel_no] 
(i.e., al4). The iomtag field must be a tag of a configured lOM and the 
channel_no must be a decimal channel number. If this control argument is used, 
the mpc_name argument is optional. If both are used, the channel must be 
connected to the mpc specified. 

-output_file {path}, -of {path} 

directs dump output to the segment specified by path. If path is not given, a 
default segment name of [mpc_name3 .list is used. If this control argument is not 
given, the default is to direct output to your terminal. 

-long 

formats output for devices with 132 columns or more. The default is based on 
output type and can be used to override the file output default. 

-short 

formats output for devices with fewer than 132 colums. The default is based on 
output file type and can be used to override the file output default. 

NOTES 

If neither the -stat, -dump, -mpc, nor -trace control arguments are specified, only the 
MFC and device statistics are displayed. 

Switch 4 on the MPC maintenance panel is used to control tracing in the MFC. 
Tracing is only done if this switch is in the down position. If the trace table is being 
dumped to see the events leading up to a particular error condition, it may be useful 
to place switch 4 in the up position as soon as possible after the error occurs. This 
inhibits further tracing of I/O in the MFC and reduces the chances of losing trace 
data caused by the table wrapping around before the dump can be taken. 
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The dump produced by this command is in a format similar to the BOS MPCD 
command described in the MOH. 



You must have re access to rcp_priv_ to use the dump_mpc command. 



Name: eis tester, et 

SYNTAX AS A COMMAND 

eis_tester path {-control_args} 

FUNCTION 

sets up and tests EIS instructions in a controlled environment. You must prepare an 
input script describing the EIS instructions to be tested. From this input script the EIS 
tester builds the EIS instructions (one at a time) and the indirect words, descriptors, 
and data that each instruction needs. The instruction to be tested is set up in a special 
ALM segment (etx). The eis_tester command calls etx in order to execute the EIS 
instruction; etx returns to eis_testeT when the instruction has been executed. After 
executing the instruction, eis_tester tests correct execution of the instruction. If one of 
the test scripts in the ets data base fails and the successful execution of that test is 
dependent upon installation of a particular FCO, the FCO number is displayed in the 
error message. 

ARGUMENTS 

path 

is the pathname of a segment that contains input script data that defines the 
instructions to test. 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses all output except identification and error messages. 

-nox 

sets up the instruction but does not execute it; used to test the validity of the 
input script. 

-debug 

runs the test in a debugging loop where each instruction is tested 10 times but 
results from the test are not checked. Each time through the loop the instruction 
is set up completely, including all the specified faults. 

-select N. -sel N, -do N 

processes only test N (where N is a positive decimal number). This number has no 
relationship to the -ns field in any test. 
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-help 

displays a brief usage statement. 

-instruction_type INSTR. -inst INSTR 

processes only tests that contain the instruction INSTR. 

-long, -Ig 

displays all the related test information prior to executing a test. 

-repeat N, -rpt N 

repeats the entire execution of the selected tests N times. 

-stop_on_failure, -sof 

displays the failing data, machine condition, and history register information and 
return to command level if an error is detected in a test. The default is to display 
the failing data and continue with the next test. 

-from N, -fm N 

starts processing test N (where N is a positive decimal number) and continues 
processing all remaining tests in the input segment unless -to is used. 

-to N 

stops processing after test N (where N is a positive decimal number). If -from is 
not used, tests one through N are processed. 

NOTES 

Before eis_tester calls etx to execute the instruction, it sets up some special padding 
around the data field that is modified by the EIS instruction. Eight special characters 
(octal 717) are put in front of and at the end of the result data string. The result area 
itself is initialized to all zero bits. 

When called to execute the EIS instruction, etx does the following: 

1. Saves the current pointers and registers. 

2. Loads the pointers and registers from values set up by eis_tester. These 
are the values of the pointers and registers when the EIS instruction is 
actually being executed. 

3. Sets indicators to preinstruction test values. 

a. All indicators except b and c below are off. 

b. The BAR MODE indicator is always on. 

c. If the test instruction is expected to turn on any of the three 
overflow indicators (ov, eo, eu), then the om (overflow mask) 
indicator is turned on so an overflow fault is not taken. 
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4. Transfers to the instruction area in etx itself where eis_tester has set up 
the EIS instruction and its descriptors. 

5. After the EIS instruction has been executed, etx stores the values of the 
indicators, pointers, and registers so that eis_ tester can examine them. 

6. Reloads the pointers and registers that were saved by etx. 

7. Returns to eis_tester. 

After the execution of the EIS instruction, eis_tester makes the following tests: 

1. Checks to see that the data resulting from the instruction is correct. 

2. Checks to see that the indicators are set correctly. 

3. Checks to see that a truncation fault was correctly taken or not taken. 



Instruction Area 

The EIS instruction is set up in a special area in etx. This area consists of seven 
words. The first three words of the instruction area are set up in the last three words 
of a page. The last four words of the instruction area are the first four words of the 
next page. By positioning the instruction in the instruction area, you can position the 
instruction on a page boundary. Those words in the instruction area that are not used 
for the EIS instruction itself are set up as nop instructions. The default position of the 
instruction word is in instruction area word 4. This places the instruction at word of 
a page. 

PAGE A 



PAGE B 



WORD 


1 


WORD 


2 


WORD 


3 


WORD 


4 


WORD 


5 


WORD 


6 


WORD 


7 



< — Default position of 
instruction word. 



Data Areas 

The data referenced by each descriptor of the instruction is set up in a special data 
area. There is one data area used for every descriptor of the instruction. Each data 
area consists of three pages. The default starling position of the data is character of 
word of page 2. The last 32 words of page 1 and the first 32 words of page 3 can 
also be used to hold the test date. Thus the maximum data size of any string is 1088 
words or 4352 (9-bit) characters. You can position the start of the data string so that 
it starts in page 1. Thus you can define data strings that cross page boundaries. A long 
data string can cross two page boundaries. 
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Notes 

Depending on what modification is used by the instruction, the data areas used may or 
may not be in the same segment. 

If a descriptor is referenced via an indirect word, then the descriptor is set up in a 
special page of its own. Depending upon the modification used in the indirect word, 
the descriptors may be in different segments. 

Page Faults 

You have control over a maximum of 13 page faults during the testing of any EIS 
instruction. These 13 pages have consistent meaning to eis_tester, even though for 
different tests they may actually be physically different pages in different segments. 

The 13 pages are 

1. Page 1 of the instruction area 

2. Page 2 of the instruction area 

3. Page containing indirect descriptor 1 

4. Page 1 of data area 1 

5. Page 2 of data area 1 

6. Page 3 of data area 1 

7. Page containing indirect descriptor 2 

8. Page 1 of data area 2 

9. Page 2 of data area 2 

10. Page 3 of data area 2 

11. Page containing indirect descriptor 3- 

12. Page 1 of data area 3 

13. Page 2 of data area 3 

Register Assignment 

You can control the type of modification used by each EIS instruction tested. However, 
for each type of modification (depending upon the descriptor number) eis_tester assigns 
the register to be used. The specific use of pointers and registers is not under your 
control when using the eis_ tester script input method. 

Pointer registers not used during the instruction are set to null (77777 11). Index 
registers and the A and Q registers that are not used are set to 8191 decimal (17777 
octal). 
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AR modification involves the use of a pointer register. Both descriptors and indirect 
words can use AR modification. A general rule followed by eis_tester is that AR 
modification implies the data referenced is in an external segment. The pointer registers 
used by eis_tester for the EIS instruction are 

AR modification in a descriptor 

descriptor 1 prl 

descriptor 2 pr2 

descriptor 3 pr3 

AR modification in an indirect word 

descriptor 1 pr4 

descriptor 2 pr5 

descriptor 3 pr7 

pr6 is used to point to your current stack frame and must be preserved in a valid state 
in order for any conditions to be signaled correctly. 

Index register modification can be specified for descriptors and for indirect words. The 
effective offsets used for index modification are always set up by eis_tester in terms of 
words. For some descriptors, the value in the index register must be in units of 
characters. The character size also varies with the value of the ta field of the 
descriptor. The index registers assigned by eis_tester and the effective word offset they 
contain are given below. 

Index register modification of a descriptor 

descriptor 1 XI 1 word 

descriptor 2 X2 2 words 

descriptor 3 X3 3 words 

Index register modification of an indirect word 

descriptor 1 X4 4 words 

descriptor 2 X5 5 words 

descriptor 3 X7 7 words 

RL modification can be specified for the descriptors of certain instructions. The value 
put in the register is specified by you. The register assigned is controlled by eis_tester. 
The following registers are used: 

descriptor 1 A 

descriptor 2 Q 

descriptor 3 X6 
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Segments Used by eis_tester to Execute an Instruction 

The execution of an instruction by eis_tester can involve up to seven segments: 

etx 



etil 


etdl 


eti2 


etd2 


eti3 


etd3 



The notation etiX means etil, eti2, or eti3, depending on which of the up-to-three 
descriptors or operands is of current interest. Similarly, etdX means etdl, etd2, or etd3. 

The first list below states the possible segments in which various items can be located, 
while the second list states what segment a descriptor or an operand is in under various 
conditions. 

ITEM 



I nstruction word 

Indirect word pointing to descriptor 

Descr iptor 

Operand 



Is AR Used Is AR Used 

to Access to Access 

Descriptor? Operand? 

No No 

No Yes 

Yes No 

Yes Yes 



eis tester Printout 

The eis_tester program prints a message noting the beginning of each instruction test. It 
also prints the number of this test. If there were errors, it prints the incorrect data or 
incorrect indicators. 

If you do not specify -bf (see "Usage" above) then the data that eis_tester has set up 
for this instruction is printed before the instruction is executed. The following notes 
describe this printout: 

1. Pointers enclosed in parentheses point to where the data is set up in the 
eis_tester segments. 

2. If none of the pointer registers are used by the instruction, then none are 
printed. The same is true of the registers. 
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SEGMENTS 


etx 






etiX 


etd 


X 










X 










X 






X 




X 






X 


X 


Descr 1 


ptor 




Operand 


Locati 


on 


1 




Location 


etx 








etx 


etx 








etdX 


eti 


X 






etiX 


eti 


X 






etdX 
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3. The names of the pages that take faults cannot be the names of all the 
pages specified in a page statement. See the last two complete examples at 
the end of this description for clarification. 

4. If the first word of a data string does not begin at character of a 
word, or if the string does not use all four characters of the last word, 
then the unused characters of the first and last words of the string are 
printed as blank characters. 

5. The test string is not printed from one of the areas used by the 
instruction but rather from one of the buffers used by eis_tester. 

6. The test and result strings are both padded by eis_iester with special 
characters. These special characters are not printed out in octal like the 
rest of the string; instead, each of these special characters is printed as 
three x's (xxx). 

How to Call eis tester 

The eis_tester program is the main procedure in the EIS instruction tester. It calls 
et_test to parse the statements in your data file. It translates these statements into the 
data needed to build and test an EIS instruction in the external segment etx. After 
building the instruction, this procedure calls etx in order to execute the EIS instruction. 
When etx returns, the results of the EIS instruction are examined. The eis_ tester 
program continues to build and test EIS instructions until there is no data left in the 
input file. The failure of one instruction only causes the termination of that one 
instruction test. Any remaining instructions specified in the input file are processed and 
tested. 



How to Write Script Input Tests 

The script input test consists of a series of eis_tester statements. The first statement in 
any test must be an inst statement. This statement signifies the beginning of one test. 

An input script segment can contain se>'eral tests. All statements from the beginning of 
the inst statement to the beginning of the next inst statement (or. if none is found, to 
the end of the segment) are considered part of the same test. 
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The format of a statement is as follows: 

name required_field {-control_args} ; 
where: 

1. name 

is the four-character statement name. There are four types of eis_tester 
statements: 

inst defines the instruction word and many control variables. 

desc defines a descriptor. 

data defines the data associated with a descriptor. 

page defines the page faults taken by the instruction. 

These statements are discussed in detail later in this document. 

2. required_field 

is required information used by all but the page statement. 

3. control_args 

are optional control arguments, explained in the individual statement 
descriptions. 

Syntax and Metalanguage 

All statements must end with a semicolon {;). There can be any number of blanks, 
tabs, and newline characters between any fields in the statement, including before the 
name field. Wherever blanks are permitted, there can also be comment fields. A 
comment field begins with a /* character pair and ends with the next */ character 
pair. 

In this description, lowercase letters are used to indicate characters that are to be typed 
in for input to eis_tester. Uppercase letters are to be replaced with the desired 
character before the script is typed. 

inst Statement 

The inst statement defines the beginning of an eis_tester test. It is used to define all 
of the fields in the instruction word of the EIS instruction. It is also used to set up 
the following special control arguments: 

1. Instruct eis_tester to execute this instruction several times. 

2. Position the instruction within the instruction area. 

3. Define an identifying string that is printed with the test. 
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An inst statement has the following format: 
inst opcode_mnemonic {-control_args) ; 
where: 

1. inst 

is the four-character statement name. 

2. opcode_mnemonic 

is the mnemonic name of a storage type EIS instruction. 

3. control_args 

are optional and can be chosen from the following: 



-tbA 

-fb 
-pb 
-rb 
-fcA 



turns on the truncation bit. The A is either y or n to signify whether 
or not the instruction is to take a truncation fault (y = yes, n = no). 
The default is n. 



turns on the fill bit. The default is off. 
turns on the plus sign bit. The default is off. 
turns on the rounding bit. The default is off. 



defines the fill character to be the character specified by A. (No 
space between c and A and no quotes are permitted.) 

-mcA 

defines the mask character to be the character specified by A. (No 
space between c and A and no quotes are permitted.) 

-In N 

defines the loop number as X. This is the number of times this 
instruction test is performed. The default is 1. The maximum value 
of X is 4. 

-io N 

defines the instruction offset. It is used to position the instruction 
relative to a page boundary. The default is 0. This places the 
instruction at word of the second page of the instruction area. X 
indicates the number of words of the instruction to be placed in the 
first page of the instruction area. The maximum value of X is 3. 
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-nt "A...A" 

defines a note. It can be used to identify each test. The term 
consists of a character string between quotes. Up to 32 characters can 
be used. No embedded quotes are allowed. 

-bo AAA 

defines a Boolean operator. AAA is the name of the operator. The 
names eis_tester has assigned to the Boolean operators are given 
below. Next to these names are the actual BOLR codes they represent. 

zer 0000 

and 0001 

axr 0010 
mov 0011 

xra 0100 

ra2 0101 

xor 0110 

orB 0111 

nor 1000 

nox 1001 

iv2 1010 

xrx 1011 

inv 1100 

xxr 1101 

nan 1110 

set nil 



Type in orB, where B is a space 



-ir {terms} 

is a multifield control argument that defines the correct state of the 
indicator registers after the EIS instruction has been executed. An -ir 
control argument can be followed by any number of specific terms. 
These terms can be in any order and can be separated by any number 
of skip fields. Each term is a two-character identifier of an indicator 
register bit. 
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A control argument of "-ir zr" means that the zero indicator is 
expected to be on at the end of the EIS instruction. Valid indicator 
register term values are 

zr zero 

ng negative 

cr carry 

ov overflow 

eo exponent overflow 

eu exponent underflow 

om overflow mask 

tr tally runout 

pe parity error 

pm parity mask 

bm BAR mode (always turned on by eis_tester) 

tn truncation 

mw multiword instruction interrupt fault 

ab absolute mode 

If the script turns on eo, eu, or ov, then eis_tester automatically 
turns on the overflow mask bit in the expected indicator's 
result. 

-mfX {terms} 

is a multifield control argument that defines one mf field of the 
instruction. Some instructions do not have mf fields in the instruction 
word for all of their descriptors. The -mfX control argument is then 
used to specify any ar or reg modification in the descriptor itself. An 
example is the mvt instruction. X denotes which mf field is being 
defined. It must be from 1 to 3 and is associated with descriptor X. 
This descriptor number can be followed by up to four terms. All 
four terms are optional and can be specified in any order. The valid 
terms are 

ar 

rl L 
idA 
reg 



The ar term 

The ar term specifies that, for this descriptor, the address register 
modification is be used to access the operand. In Multics, it is called 
pointer register modification. The pointer assigned is prX. When this 
term is specified, the data referenced by this descriptor is placed in 
the segment etdX. 
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The rl L term 

The rl L term specifies that, for this descriptor, the register length 
modification is be used. This term must be followed by a decimal 
number L, which specifies the character length of the data. The 
character size is defined within a desc statement (for 4-, 6-, or 9-bit 
characters) or inferred from the instruction mnemonic (for bit 
strings). This value is placed in the selected register, and the N field 
of descriptor X contains the register modification tag code. The 
registers assigned are 

X = 1 - A 
X = 2 - Q 
X = 3 - x6 

The idA term 

The idA term specifies that descriptor X is to be referenced via an 
indirect word in the instruction. In the idA term, the A denotes what 
modification is to be used in the indirect word: a for address 
register, r for register, or b for both. 

If no A character is given in the idA term, then there is no A 
modification in the indirect word. 



ida 



idr 



idb 



specifies that address register modification is to be used to 
access the descriptor. When this is specified, the descriptor is 
placed in the segment etiX. 

The pointer registers assigned to the indirect word are 

indirect word 1 => pr4 
indirect word 2 => pr5 
indirect word 3 => pr7 



specifies that register modification is to be used to access the 
descriptor. The indirect word is modified by index register 4, 
5, or 7. 

NOTE: This modification is in terms of words, 
specifies both a and r modification as described above. 
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The reg term 

The reg term specifies that descriptor X is to be modified by an 
index register. The value in the index register is a character offset 
and is (X*4). The index register assigned is index register X. The 
value placed in index register X is dependent upon the type of 
instruction and the appropriate character size. It is in the following 
units: 



WORDS 



BITS 



CHARS 



for those descriptors that have no mf field in the instruction 
word 

for all bit string instructions 

for all others. The actual units depend upon the character 
size. The default is a 9-bit character size. 



If it is necessary to write a script in which the placement of the instruction, indirect 
words, descriptors, and operands in specific segments is important, the following list is 
help. 



Script Elements Used 
in-mfX Fields 



id 



id 



ar 

ar 

ida ar 

idr ar 

idb ar 



ida 



idr 



idb 



Descr 


iptor 


Operand 




Locat 


ion 


location 




etx 






etdX 


etx 






etdX 




etiX 




etdX 


etx 






etdX 




etiX 




etdX 


etx 




etx 






etiX 


etiX 




etx 




etx 






etiX 


etiX 
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Examples of inst Statements 

/A Example 1 . 't/ 

inst mlr -nt "Example 1 " 

-fc* /* Comments can go anywhere except inside a term */ 

-fb 

-mf2 /" Note order is not important. */ 
rl 3 id ar reg 

-mfl ar idb reg rl 3 ; /* Statement must end with ";" */ 



/* Example 2. */ inst cmpc /* mnemonic name must 

'^ be first term. */ 
-mfl ar 

-nt " example 2" -mf2 rl 3 

-fc /* Use escape to enter octal character */ 
-ir cr zr ; />'« Indicator bm i s on by default. >'«/ 



/* Example 3« */ 

inst scm 
-mc9 
-In 3 
-io 2 

-mfl reg ar 
-mf2 ida; 



-nt "scm examp." 

/* Make this test 3 times. */ 

/iff Put instruction word and first descriptor 

* in page 1 of instruction area. ■>'•>/ 



/,v 



Example h. */ 



inst ad3d 

-mf3 ar -mf2 reg -mfl idr 

-rb -pb; 



/" -mfx items can be in any order */ 



/" Example 5- */ 

inst csr -fb -bo and -mf 2 rl 36; 
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desc Statement 

The desc statements are used to specify certain fields in the descriptors. Each desc 
statement deals with only one descriptor. The fields in a descriptor not specifically set 
up by a desc or an inst statement are set to zero. If zero bits in all of the fields are 
needed, then no desc statement need be specified for that descriptor. 

The -cp, -bp, and -en fields of a desc statement interact with the -do field of the 
associated data statement. See the complete examples at the end of the eis_tester 
description for illustrations of the interactions. 

In general, the order of the desc statements is not important, and the can be mixed in 
with any other statements. However, if the instruction is CMPC, SCD, SCDR, SCM, or 
SCMR, then the desc 2 statement cannot specify a -ta field. Descriptor 2 must use the 
value specified in descriptor 1. To use this feature, the desc 1 statement must precede 
the desc 2 statement. 

A desc statement has the following format: 

desc num {-control_args} ; 

where: 



1. desc 

2. num 



is the four-character statement name. 

is the number of the descriptor. It must be 1, 2, or 3. 



control_args 

can be chosen from the following: 

-cp N 

is used in bit string instructions to specify a (9-bit) character offset 
when developing an operand address where N must be a number from 
to 3. 

-bp N 

is used in bit string instructions to specify a bit offset within a 9-bit 
character when developing an operand address where N must be a 
number from to 8. 



-en N 



is used in character string instructions to specify a character offset 
when developing an operand address where N must be a number from 
to 7. The quantity of bits associated with each character (4, 6, or 9 
bits) is specified by the N argument supplied with the -ta or -tn 
control argument. 
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-ta N 

defines the alphanumeric character type where N must be 9, 6, or 4. 
The default value is 9. 

-tn N 

defines the type of numeric character where N must be either 9 or 4. 
The default value is 9. 

-sd STR 

is the sign and decimal type. The STR argument must be one of the 
following characters: 

f - Floating point, leading sign 

1 - Leading sign, scaled 

t - Trailing sign, scaled 

n - No sign, scaled 

-sf N 

is the scaling factor where N is a signed (or unsigned) decimal 
number. 

-ns N 

is the number of characters or bits in a string where N is an 
unsigned decimal number. There is no default value. 

-nn N 

is the number of characters in a numeric string where N is an 
unsigned decimal number that must not be greater than 64. There is 
no default value. 
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EXAMPLES 

/* Example 1. V 

desc 1 -ns 8 -ta 6 -en 5; 

/* Example 2. */ 

desc 3 "cp 2 

-bp /ift Comments can come between control argument names 

* and the term. */ 5; 
/* No -ns control argument. This is valid if -mf3 

* control argument In inst statement 

* specified rl term. */ 

/* Example 3. */ 

desc 2 

-tn k -en 3 "Sd n /* No sign. */ 

-sf -100 -nn 12; 

data Statement 

The data statements are used to describe the data that a descriptor references. Every 
test requires at least as many data statements as there are descriptors for the EIS 
instruction being tested. 

The eis_tester program can determine which descriptor references the result data. The 
data entered for this descriptor is not set up in the data area referenced by the 
descriptor. Instead, this data area is initialized to all zero bits. The input data is saved 
and used to test the result of the instruction. Some special notes about data statements 
are given below: 

1. For those instructions that both read and write data into the same string 
(e.g., ad2d, sb2d), you must enter a data 3 statement that describes the 
resulting data referenced by descriptor 2. The data input via the data 2 
statement is the data initially referenced by descriptor 2. 

2. The data pointer for each descriptor is set by default to character of 
word of page 2 of the data area for that descriptor. You can adjust 
this data pointer by certain (9-bit) character offsets. 

3. The input string defined by you is placed in the data area starting at the 
first character referenced by the effective data pointer. It is important to 
remember this. If the descriptor associated with this data area specifies 
that the first character of the string is not character of the first word, 
then the missing data must be reserved when the input string is specified. 
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4. The -do field of a data statement interacts with the -cp, -bp, and -en 
fields of the associated desc statement. See the complete examples at the 
end of the eis_tester description for illustrations of the interactions. 

A data statement has the following format: 

data num {-control_arg} data_fields: 

where: 



1. data 



num 



is the four-character statement name. 



is the number of the data field. It must be either 1, 2, or 3. In 
some cases, a data 3 statement is valid even when there is no third 
descriptor. In this case, it is used to input test data. See the last 
complete example (csl instruction) at the end of this description. If 
the descriptor that points to this data does not use address register or 
register modification, then only offsets that are a multiple of 4 are 
accepted. The data used by EIS instructions is always string type data, 
and thus the input modes are limited to the two described below. 



conlrol_arg 
-do X 

data_fields 



can be 



where X must be a decimal integer from -128 to +4096 that 
represents a 9-bit character offset from character of the middle 
page of the data area. 



are the following types. They can be intermixed. The maximum size 
of the data is 1088 words (4352 characters). 

ASCII 

is an ASCII string. It must be enclosed in quotes. The maximum size 
of any one field is 256 characters. Quote characters can be entered in 
the siring by expressing them as double quotes (""). 

OCTAL 

is a string of octal digits. The first nonoctal-digit-type character 
found indicates the end of a string of octal data. The converted octal 
string is padded on the right with zero bits to make it an integral 
number of 9-bit characters. For example, data 123 45 6 7777- 
becomes 123 450 600 777700. 

The repetition factor (XX), an unsigned decimal number enclosed in 
parentheses, can be used to specify the repetition of a field. Only the 
data field immediately following the repetition field is repeated. 
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EXAMPLES 



/* Example 1. four characters of data starting at the 



jV 



beginning of the default data area. */ 



data 3 "abed"; 



/* Example 2. Moves the same data field back two 

* characters. This splits the string across a page. 

* NOTE: The input string is the same even though it is 
entered differently. ''«/ 

data 2 -do -2 "ab" "cd"; 



/''• Example 3« The same as example 2 only it specifies 
* some of the data in octal. */ 

data 1 "ab" ]kj>]kk -do -2; 



/* Example k. A string of: 

'• "12121212121212121212", that is 10 "12" strings. */ 

data 2 "12" 06l062 "1" "2" 
061 062 
(3) "12" 
(3) 061062; 



/* Example 5. The effective data address to be 

* word 1 of page 2 of the data area. However, the en 
'• field of the descriptor specifies that the first 

* character of the word that is used is character 

* 3- Put some fill characters in the first 

* three characters. 



*/ 



data 2 -do k "**■>'<" /* Fill characters. Not 

'■« referenced by the instruction. */ 
"abed" ; /* The actual data string with which 

" the instruction works. */ 
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page Statement 

The page statement is used to control page faults during the execution of the EIS 
instruction. The default case is that no page faults occur. The eis_tester program 
requires that you specify those pages on which faults are to be taken. 

If you specify a page that is not actually used by the instruction (for example, the 
third page of a data area that has a one-character string), there is no harm. There is 
also no page fault. 

All the pages used by an EIS instruction have been assigned names. For pages other 
than the two instruction area pages, the names can reference physically different pages. 
Their use by the EIS instruction is always the same. 

The format of a page statement is 

page {-controLargs} ; 

where: 

1. page 

is the four-character statement name. 

2. controLargs 

specify what pages are to have page faults and be chosen from the 
following: 

-inl -in2 

the two pages of the EIS instruction itself take a page fault. 

-idl -id2 -ids 

the pages used by descriptors referenced via indirect words take a 
page fault. 

-dll -dl2 -dl3 

the three pages of data referenced by descriptor 1 take a page fault. 

-d2l -d22 -d2.3 

the three pages of data referenced by descriptor 2 take a page fault. 

-dSl -d32 

the two pages of data referenced by descriptor 3 take a page fault. 



-all 



specifies that all of the pages defined for this instruction take a page 
fault. If other control arguments are entered along with the -all 
control argument, then the pages specified do not have page faults. 
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Running eis tester with Other Users 

If eis_tester is to be run while other users are on the system, it is not possible to 
positively guarantee that selected pages will not take a page fault. The "page -all;" 
statement causes eis_tester to flush all the pages of the etx, etil, eti2, eti3, etdl, etd2, 
and eid3 segments out of main memory. Using "page -all -in2;" results in flushing all 
pages, touching page in2, and transferring control to etx. The touching of page in2 
brings it into main memory. However, the overall system activity may be such that 
eis_tesier loses control before reaching page in2, eis_ tester and etx being displaced by 
pages for other users, control being returned to etx, execution continuing, and page in2 
being no longer in memory. Then, when page in2 is needed, a page fault occurs. 
Therefore, a general guideline is: if eis_tester is run when other users are on the 
system, use the "page -all;" statement. 

However, if eis_ tester is to be run as the only user (nondaemon) process on the system 
and the "page" statement is not used, the pages should be in main memory when 
wanted. Some hardware problems may require running tests with and without page 
faults to isolate the problem. You should be aware that just because eis_tester attempts 
to avoid a page fault and the eis_tester output does not state that a page fault will 
occur does not necessarily mean that a page fault will not occur. 

EXAMPLES 

/* Example 1. */ 

page -in2 -id3 -d32 
-d12 -dl2 -dll -idl; 

/* Example 2. */ 

page -a1 1 ; 

/A Example 3. Take faults on ALL pages EXCEPT 
" pages i n2 and id3 */ 

page - i n2 -all -id3; /* Notice order is not 

'■' important. '>/ 
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EXAMPLES OF ACTUAL TEST SCRIPTS AND THEIR OUTPUT 



/* mlrlO 

* This test is the same as the test mlr3 except that 

* the descriptors use AR, REG, and RL modification 

* and use indirect descriptors. The indirect 

* words use both REG and AR modification. 



'V 

inst mlr -nt "10." -io 1 

-mfl rl 20 

ar /* This puts the data in etdl. */ 

reg />'« Use index register 1.. */ 

idb /* This adds indirect descriptors. Descriptors 
* go in segments etil and eti2. */ 

-mf2 idb 

rl 20 

reg 

ar; 

desc 1 -en 2; 

desc 2 -en 2; 

data 1 -do -20 " " (5) "abed" ; 

data 2 -do -20 000 000 (5) "abed" ; /* Fill for -en 2 

* must be zeros. >V 

page -inl -in2 
-d22 -d21 
-dll -dl2 
-id! -id2 
-id3 -d32; 

et mlrlO -nox 

/''«The absence of any output from the 

*et mlrlO -nox input line means that the 

^script passes the validity checks that eis_tester performs. */ 
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et 

TEST 1 (mlr) 

EIS instruction: ( 262|3777 ) I nd Desc, 
000172100571 



lt0003i»00011i( -> 100007200005 ( 327 
5OOOA3OOOII5 -> 200016200006 ( 330 



100 ) 
100 ) 



Pointer Registers: ( 262|20 ) 

pro - pr3 777777|1 332|1763 333|1753 777777|1 
pr4 - pr7 327|'tO 330|30 777777|1 777777p 

Index Registers: ( 262|70 ) 

xo - X7 17777 ^ 10 777 ^ 5 17777 17777 

A 00000000002i» Q 000000000024 

Test Indicators: ( 262|111 ) 
000000000200 

This test takes 8 page faults. 

in! in2 idl dll dl2 id2 d21 d22 

data field 1 ( 332|1773 ) 

000000U1U2 I43l4ifli»lli42 Ilt3l4i»lltl U2 ]lt}]kk]k]]k2 
lA31iti>lifllif2 1it31'*4 

data field 2 ( 333|1773 ) 

Result data field initialized to all zero bits. 

test data ( 262| 15776 ) 

xxxxxxxxxxxx xxxxxxxxxxxx OUOOUOlitl 142 143144141142 

U3U2,141142 143144141142 143144141142 l43l44xxxxxx 

xxxxxxxxxxxx xxxxxx 

/" Test mvt instruction. */ 

inst mvt -nt "3" -fc /* Char is octal 1. ■>''/ 

-mf 1 rl 3 af reg idr 

-mf2 ar reg ida 

-mf3 reg ar; 

desc 2 -ns 8; 

data 1 -do -2 OO3 002 001; 
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data 2 -do -6 "321111" "11"; 
data 3 -do -1 "0" "123"; 

page -all -in2; 

et 

TEST 1 (mvt) 

EIS instruction: 



( 262|i»000 ) Ind Desc, 



001132160571 
05177^000014 
500050000100 
300025000113 



-> 
-> 



100007000005 ( 262 
200016000010 ( 330 



52000 ) 
100 ) 



Pointer Registers: ( 262 | 20 ) 
pro - pr3 777777 1 332 
pri* - pr7 777777 1 330 



1767(18) 333|1756(18) 33^*1 1 7^+7 (27) 
30 777777 1 1 7777771 1 



5 17777 17777 



Index Registers: { 262 |70 ) 

XO -X7 17777 k ]0 m k 
A 000000000003 Q 000000017777 

.Test Indicators: ( 262 I 11 1 ) 
000000000200 

This test takes 11 page faults. 

idl dll dl2 dl3 id2 d21 d22 d23 d31 d32 d33 

data field 1 ( 332| 1777(18) ) 
003002 001 

data field 2 ( 333|1776(l8) ) 

Result data field initial ized to all zero bits. 

data field 3 ( 33'*| 1777 (27) ) 
060 061062063 

test data ( 262|15776 ) 

xxxxxxxxxxxx xxxxxxxxxxxx 063062061061 061061061061 
xxxxxxxxxxxx xxxxxxxxxxxx 
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NOTES 

A standard set of scripts is provided that can be used with eis_tester. If CPU problems 
with the EIS instructions are suspected, these scripts should be run. The ets segment's 
standard location in the storage hierarchy is >tools>ets, but an installation can locate ets 
somewhere else. 

EXAMPLES 

/" An example to illustrate the interaction between 
'V the "-do" and the "-en" fields. 

inst mlr -ir tn -nt "-do and -en interaction" 

-mf 1 idb ar reg -mf2 idb ar reg; 
/* The uppercase letters in the two data statements could have been 

* typed in as "ABCDEFGH" and "CDEF" but were typed in as they are 

* shown so that explanatory remarks could be placed on the adjacent 
>'« lines. The symbols used above and below the desc and data lines 
»'« mean: 

>'« P The boundary of a page, and hence, also a word 

>'! boundary. 

* S -S The operand string portion of the data field. 

>'« W A word boundary. 

* W P W V 
desc 1 -en 2 -ns 6;data 1 -do -5 "A" "B" "C" "D" "E" "F" "G" "H" "I" ; 
/>•< S ____-_-s 

'*' Each uppercase letter in the above data statement occupies 9 bits. 

" Note that the data field for the first operand starts five 9~bit 

* bytes to the left of a page boundary. This is due to the "-do -5" 
»v field. However, the operand string excludes the first two bytes 

* of the data field, because of the "-en 2" field. 
J, 

* P W ft/ 

desc 2 -en 3 -ns it;data 2 -do -1 000 000 000 "C" "D" "E" "F"; 
/,-. S__ __s 

* The data field for the second operand starts one 9-bit byte to the 
" left of the page boundary due to the "-do -1" field. The "-en 3" 

* field results in the operand skipping over the first three bytes of 
>'- the data field. Another way to specify the CDEF string to fall 

>': where it does would be to use these desc 2 and data 2 statements: 

* desc 2 -ns k; data 2 -do 2 "CDEF"; 

* The "-en 3" and 000 000 000 were used to show how to do it when 
" the person writing the script wants to use the CM field in the 

* second descriptor. >•/ 
page -all; 
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COMMENT 
COMMENT 
COMMENT 

ET 

TEST 1 



The output from running eis_tester with the above script is shown 
below. Explanatory remarks have been inserted in the 
output, on the lines that start with COMMENT: 



(mlr) 



Test Description: 

Eis instruction: 

000132100531 
40003^000 lU 
500043000115 

Pointer Registers; 
pro - pr3 



-do and -en interaction 
( 340 14000 ) Ind Desc. 



-> 100007400006 
-> 200016600004 



( 341 
( 342 



100 ) 
100 ) 



( 340 1 20 ) 
777771 1 344|1766(27) 345|1757(27) 77777|1 



COMMENT: The value in the parentheses following a word offset, which 
COMMENT: is in octal, is the bit offset, in decimal. 



pr4 - pr7 34l|40 342|30 77777|l 77777|1 



ndex Registers: ( 340|70 ) 
xo - X7 17777 4 10 
A 000000017777 Q 



17777 4 5 
000000017777 



17777 17777 



Test Indicators: 
000000000300 



{ 340|111 ) 



This test takes 7 page faults. 

in2 idl dl 1 dl2 id2 d21 d22 



COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 



Page d21 is included here because data_field_2 crosses the 
boundary between the first and second pages of the etd2 
segment. However, because of the "-en 3" field, operand_2 
actually resides in only the second page. Therefore, the 
first page is not be touched, and no page fault occurs 
for page d21 . 
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data field 1 



COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 



( ii*k\M7G(27) ) 

101 102103104105 106107110111 
S s 

It is true that data_field_l begins in bit 27 of word I776, 
However, because of the "-en 2" field, operand_l begins 
with bit 9 of word 1777' The address development 
(in octal) for the start of operand_l is: 



ITEM SEGMENT|WORD 9-BITBYTE 



desc_l 

prl 

xl 

which is 
I f the same 
operand, it 
one page 
Refer to 
"desc 2" 
adjacent 



3kk 
Ok 
34i. 
3ifU 



7 
1766 

1775 
1777 



calcul ations 
is seen that 



2 
3 

11 
1 
are 
the 



or 34411777(9) 
carried out for the second 
data field starts in 



but the operand starts in the next page, 
the script line above that contains the 
and "data 2" statements and then examine 
1 i nes. 



the 



data field 2 

Result data 



( 345 1 1777 (27) ) 
field initial! zed to 



al 1 zero bi ts , 



test data ( 340| 15776 ) 

xxxxxxxxxxxx xxxxxxxxxxxx 000000000103 104l05106xxx 

COMMENT: S S 

COMMENT: The xxxxxx represent fill supplied by eis_tester. The nine 
COMMENT: leading octal zero digits are present because they were 
COMMENT: supplied in the "data 2" statement. 

xxxxxxxxxxxx xxxxxxxxx 



/A An example to illustrate the interaction between 

* the "-do" and "-cp" and "-bp" fields. 'V 

inst csl -bo or -nt "-do and -cp and -bp interaction" 

-mf 1 idb ar reg -mf2 idb ar reg; 
desc 1 -cp 2 -bp 3 "ns 30; 

/* The symbols used above and below the data lines mean: 
" P The boundary of a page, and hence, also a word 

* boundary. 

" S S The operand string portion of the data field. 

" W A word boundary. 

'•' W P */ 
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data 1 -do -? 123 ^56 701 020 203 O^tO 123 ^56 765; 
/A s~r s 

'< Data_field_1 starts seven 9-bit bytes before the page boundary, 

* due to the "-do -7" field. The "-cp 2" field causes the processor 

* to skip over the first two bytes (123 ^56 octal), so that 

* operand_l starts somewhere in the 701 octal byte. The 

5'c "-bp 3" field causes the processor to skip over the first three 

* bits (7 octal) of the 701 byte, thereby starting at bit 30 

* (bits numbered 0-35) of the next to last word of a page. 

A/ 

desc 2 -cp 1 -bp 6 -ns 30; 

/* Pxxx W w */ 

data 2 -do 1 1*32 I03 O3O i»05 050 765 i»32 101; 

/'■' S S 

* The "Pxxx" above the "data 2" statement is intended to 

* indicate that the page boundary is three octal digits (the xxx) 

* i.e., nine bits, before the start of data field_2, as 

* specified by the "-do 1" field. The "-cp~l" field specifies 

* skipping over the first 9-bit byte, to the IO3 octal byte. 

* The "-bp 6" field specifies skipping the first six bits of 

* that byte, to the octal 3, which begins in bit position 2k 

* (of 0-35) in the first word of a page. 

* W w >V 
data 3 k^Z I03 132 425 35'* 765 '♦32 101; 

/* S- S 

* The "data 3" statement is used because the csl instruction 

* stores its result in the same bit locations from which the 

* second operand was fetched. No "-do", "-cp", or "-bp" fields 
>'< are needed for the "data 3" statement because eis_tester 

* associates the attributes of data field_2 and operand_2 with 

* the data supplied by the "data 3"~statement. 



page -all; 

ET 

TEST 1 (csl) 

Test Description: -do and -cp and -bp interaction 

Eis instruction: ( 33i»|itOOO ) I nd Desc. 

007132060531 

40003^000114 -> 100007430036 ( 335 

500043000115 -> 200016260036 ( 336 



100 ) 
100 ) 



Pointer Registers: ( 334|20 ) 

pro - pr3 77777|1 340|1766(9) 34l|1760(9) 77777|1 
pr4 - pr7 335|40 336|30 77777|1 77777|1 
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Index Registers: ( 334J70 ) 

XO - X7 17777 '♦i 110 
A 000000017777 Q 



Test Indicators: 
000000000200 



( 33M111 ) 



17777 't 5 
000000017777 



17777 17777 



This test takes 7 page faults, 



in2 
COMMENT 
COMMENT 
COMMENT 



idl dll dl2 id2 d22 d32 

Page dl2 is listed here because data_field_l is in both 
pages 1 and 2. However, operand_l is in only page 1, 
so a page fault does not occur for page dl2. 



data field 1 

123^*56701 
COMMENT: S- 



( 340 I 1776 (9) ) 
0202030^0123 U56765 

— S 



data fie 

COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 



Id 2 ( 3'tl I 2000 (9) ) 
it32103030 405050765't32 101 
S- S 

The address development for the 
shown below. For x2, 110 octal 
and no bits. 

9-BIT BYTE 
SEGMENT [WORD IN WORD 
ITEM (OCTAL) (BINARY) 



start of operand_2 is 
= 72 decimal = 2 words 



desc 
pr2 " 
x2 



3M 



16 


01 


1760 


01 


2 


00 



BIT IN 

BYTE 

(BINARY) 



0110 
0000 
0000 



34 1 I 2000 



10 



0110 



which is segment 3^1 i word of the second page, 9-bit 
byte number 2 (numbering is O-3) . and bit number 6 
(of 0-8) , i .e., 341 12000(24) . 



test data 

xxxxxxxxxxxx 
COMMENT 
COMMENT 
COMMENT 
COMMENT 
COMMENT 



( 33M23776 ) 
xxxxxxxxxxxx 432103132425 354765432101 

S S 

The leading fill of i»3210 and the trailing fill of 
765432101 were not affected by the execution of the 
instruction, proving that bits outside the operand 
strings did not enter into the instruction's execution. 



xxxxxxxxxxxx xxxxxxxxxxxx 
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Name: exercise disk 

SYNTAX AS A COMMAND 

exercise_disk disk_type volume_id {-control_args} 

FUNCTION 

exercises a disk drive. Maximal arm motion occurs all over the disk, and data is 
written and read back later for checking at each point. This activity can be used to 
make unstable drives fail repeatedly. 

ARGUMENTS 

disk_type 

a valid Multics disk device type (e.g., d451, dSOO, and dSOl). 

volume_id 

the label of the disk pack on which the test is to be run. 

CONTROL ARGUMENTS 

-write_read, -wr 

writes a known pattern over the entire disk pack, and then reads this information 
back for checking purposes. This is the default. 

-write, -w 

writes a known pattern over the entire disk pack. The default is -write_read. 

-read, -r 

reads back the information on the disk pack, for checking purposes. The default is 
-write_read. 

-device STR, -dv STR 

specifies the device on which you want to run the test, where STR can be dska_02, 
dskb_13, etc.). Either this control argument or the assign_resource (ar) command 
must be used to attach an I/O disk. 

-no_data_corapare, -ndc 

makes no data compare on the read pass; only errors detected by the hardware are 
reported. This enables testing of a disk pack without knowing what data is 
recorded on it. The default is to compare the data with a known pattern. 

-random 

the test performs random rather than sequential seeks; the test takes several hours. 
This is the default. 

-sequential, -sq 

the test runs sequentially, writing and reading from sector 0. 
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-alternate_track, -altrk 

removes the alternate track area of the disk from the test parameters. The default 
is to use the entire pack. 

-from M, -fm M 

sets the lower limit of the range of addresses to be tested to M, where M is a 
decimal integer specifying a valid cylinder number for the device to be tested. 

-to N 

sets the high limit of the range of addresses to be tested to N, where N is a 
decimal integer specifying a valid cylinder number for the device to be tested. 

NOTES 

The exercise_disk command requests the mounting of a scratch pack. 

The assign_resource command must be used in conjunction with this command to 
exercise a given drive. Such drives must be configured as user I/O drives (nonstorage 
system) via the UDSK CONFIG card (see the description of the UDSK CONFIG card 
in the MOH) or by the use of the set_drive_usage (sdu) initializer command. 

When the -from or -to control arguments are used, testing is confined to the range of 
addresses specified. The seek pattern used in this mode is from inner cylinder to outer 
cylinder, v/ith M incrementing to N or the maximum address of the device, and N 
decrementing to M or cylinder zero. When M reaches its inner limit, the pattern is 
repealed. Testing continues until stopped by the user, by hitting the break key and then 
typing the release (rl) command. 



Name: fnp data_summary 

SYNTAX AS A COMMAND 

f np_data_summary {f np_names} {-control_args} 

FUNCTION 

reports error statistics recorded in the syserr log by the poll_fnp command. The 
statistics reported include parity errors for all channels and various counters for 
synchronous channels whose interpretation depends on the line type of the channel. 
Only nonzero statistics are reported. 

ARGUMENTS 

fnp_names 

are the names of FNPs for which statistics are to be reported. If no fnp_names 
are specified, statistics are reported for all FNPs for which any nonzero statistics 
are available. 
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CONTROL ARGUMENTS 

-expand 

displays in expanded form every entry in the syserr log containing statistics for the 
specified FNP(s). 

-extend, -ext 

appends the output of the command to the end of the output_file if it already 
exists. This control argument can be specified only if -output.file (below) is 
specified. 

-from DATE_TIME, -fm DATE_TIME 

starts scanning the syserr log from the time specified bv DATE_TIME which must 
be a character string acceptable to convert_daie_to_binary_. The default is to start 
at the beginning of the log. 

-for TIME 

restricts the scan of the syserr log to an interval of length TIME, where TIME is 
a character string representation of a time interval in a form acceptable to 
convert date_to_binary_. This control argument is incompatible with -to (below) 
ine default is to continue the scan up to the end of the log. 

-output_file {PATH}, -of {PATH} 

directs output to a file. If PATH is specified, it is the pathname of the output 
file; otherwise, output is sent to fnp_data_summary.output in the current working 
directory. If -output_file is not specified, the default is to direct output to your 
terminal. ^ ^ 

-to DATE_TIME 

ends the scan of the syserr log at the time specified by DATE_TIME. which must 
be a character string acceptable to convert_date_to_binary_. This control argument 
is incompatible with -for (above). The default is to continue the scan to the end 
of the log. 



Name: io error summary 

SYNTAX AS A COMMAND 

io_error_sunimary {-control_args} 

FUNCTION 

scans the syserr log and summarizes I/O errors in a brief report. 
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CONTROL ARGUMENTS 

-cylinders, -cyl 

separates the disk device error by cylinder and head. Only disk_conlrol can be 
separated. 

-from DT, -fm DT 

starts scanning the log at the date /time given. 

-to DT 

stops scanning the log at the date/ time given. 

-for T 

computes the ending time from the starting time, where T is a relative time {such 
as "1 hour"). 

-device STRs, -dv STRs 

reports information for the device(s) named, where STRs are device types ("prt") or 
device names ("prtb"). 

-detailed_status, -dtst 

displays detailed status if available. 

-hex_detailed_status, -hxdtst 

displays detailed status in hexidecimal if available. 

-tape_data_bit_in_error, -tdbie 

displays the data bit(s) in the detailed status that were in error. 

-status status_list, -st status_list 

reports information for the lOM status listed, where status_list is the lOM major 
and substatus ("0310" or "4310"). 

NOTES 

If -from DT is not specified, the scan starts with the earliest message in the syserr log. 
The ending time can be specified by using -for, or -to, but not both. If both are 
omitted, the scan terminates with the last message in the log. All dates and times must 
be in a format acceptable to convert_date_to_binary_ described in the Subroutines 
manual. 

You must have re access to audit_gate_ and r access to the permanent_syserr_log and 
config_deck segments to use this command. 



2-74 AR.97-03 



list_proc_required list_proc_required 



Name: list proc required 

SYNTAX AS A COMMAND 

1 ist_proc_required {-contro1_args} 
FUNCTION 

determines the group of CPUs on which the invoking process can be run or the default 
group of CPUs for all processes that have not requested specific CPUs. 

SYNTAX AS AN ACTIVE FUNCTION 

[1 ist_proc_required {control_args}] 

CONTROL ARGUMENTS 

-priv 

indicates that this command applies to the default group of CPUs for processes 
that have not requested specific CPUs. If omitted, this command applies to the 
group of CPUs for the invoking process only. 

NOTES 

When invoked as a command without the -priv control argument, list_proc_required 

indicates that the set of CPUs needed for this process is the system default by printing 

(default)" following the list of CPUs. This information is not provided when 

list_proc_required is invoked as an active function. If invoked as an active function it 

"!^^!^"i.,/ ^^""^ °*" ^^^ ^^ ^^^^ represent the group of CPUs requested (e.g., 
ABCF ). 

This command prints the list of CPUs required as an uppercase string. If invoked as an 
active function, this returned list of CPU tags is in uppercase. 

ACCESS REQUIRED 

It requires access to phcs_ or metering_gate_. 

EXAMPLES 

This command is most useful when used in conjunction with the set_proc_required 
command to verify that the restriction specified in an earlier invocation of set_proc_required 
IS still in operation. The effect of set_proc_required can be canceled by the system 
because of dynamic reconfiguration without notification to the process affected If the 
following set of commands are input: 
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set_proc_requi red A 
{other commands} 
1 ist_proc_required 

an output of "A" from list_proc_required indicates that all commands between the 
sel_proc_required and the list„proc_required were run entirely on CPU a. Any other 
output indicates that the effect of the set_proc_required has been canceled due to 
dynamic reconfiguration. 



Name: load mpc 

SYNTAX AS A COMMAND 

load_mpc {mpc_name} {-contro1_args} 

FUNCTION 

loads ITRs or application firmware or both into MFCs. 

ARGUMENTS 

mpc_name 

is the name of the MPC to be tested or reloaded or both. This name must appear 
on an MPC card in the config deck. If this argument is omitted, the -channel 
control argument must be given. 

CONTROL ARGUMENTS 

channel channel_name, chn channel_name 

specifies a channel name, where channel_name is of the form {iomtag} channel_no 
(for example. al4). The iomtag field must be the tag of a configured lOM and is 
required on multiple lOM systems. The channel_no field is an octal channel 
number. If this control argument is used, the mpc_name argument is optional. If 
both are used, the channel must be connected to the mpc specified. 

-itr 

loads only the ITRs; the standard firmware is not reloaded. 

-firm 

loads ony the standard firmware; ITRs are not run. 

-revision RV, -rev RV 

specifies which revision firmware is to be loaded, where RV is a 2-character 
firmware revision code. If multiple revisions exist and this argument is omitted, 
you are queried as to which revision to load. 



2-76 AR97-03 



load_nipc mc_trace 



-time, -tm 

prints timings for each program loaded into the MPC. 

-brief, -bf 

withholds printing of the names of the programs as they are run. 

NOTES 

By default this command suspends I/O on all devices connected to the selected MPC, 
resets the controller, runs all the known ITRs, reloads the standard firmware (including 
device routines for urmpc), and restores I/O on all devices connected to the controller. 

If any abnormal conditions occur, the program displays the status that occurred, and 
stops, I/O is left in a suspended state, because the MPC has been left in an unusable 
state. In order to return the controller to operation, it is necessary to restore the 
firmware, using either this command or TOLTS (documented in the Online T&D 
manual). 

This command can be used on disk MPCs only if they are fully cross barred. 

Firmware and ITR modules are found in the Test and Diagnostics (T&D) deckfile 
created by the load_tanddJibrary command (also documented in the T&D manual). 



Name: mc trace, met 

SYNTAX AS A COMMAND 

mc_trace path {-control_args} 

FUNCTION 

gives a snapshot of machine conditions and history registers (resulting from hardware 
faults and interrupts) incurred while executing another Muliics command or subroutine. 

ARGUMENTS 

path 

is the absolute or relative pathname of the segment that is to be traced. 

CONTROL ARGUMENTS 

-all 

captures machine conditions and history registers for every fault and interrupt that 
occurs in your process. This control argument cannot be used with -he or the path 
argument. 

-brief, -bf 

suppresses printing your prompt " — >". 
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-buffer N. -buf N 

sets the machine condition trace buffer size to N, where N is a decimal integer 
value from 1 to 16, and represents the buffer size in units of 1024 words (IK). 
The default buffer size is 5K words. 

-he SEG 

captures machine conditions and history registers for faults and interrupts that 
occur in the hardcore segment SEG while your process is in execution. SEG can 
be a hardcore segment name or number. This control argument cannot be used 
with -all or the path argument. 

NOTES 

This command initiates the segment specified by the path argument, and creates the 
machine condition trace buffer in your process directory. The number of machine 
conditions and history register sets that can be stored is directly related to the size of 
the trace buffer. There is an approximate 8 to 1 ratio of machine conditions to history 
registers (e.g., in a 5K buffer there would be storage for 79 sets of machine conditions 
and 10 sets of history registers allowing room for a trace buffer header). The trace 
buffer is temporarily "wired" (i.e., the segment remains in main storage and is not 
subject to removal by the dynamic paging mechanism). The hardcore snapshot or trace 
mechanism is then enabled and mc_trace goes into a request loop after printing " — >" 
as your prompt on the error_output switch. The valid user reponses while in this 
request loop are as follows: 

1. . 

prints out the command name "mc_trace" on the user_output switch. 

2. .q 

turns the hardcore snapshot mechanism off, unwires the machine condition 
buffer, and returns to Multics command level. 

3. ..< command > 

calls the Multics command processor and executes <command> as a 
Multics command (e.g., ..who). 

4. .rpt n <command> 

calls the Multics command processor to loop n times, executing the 
specified Multics command <command>: n is an integer from 1 to 
99999999 (e.g., .rpt 10 who). 

5. .pmc m n 

displays machine conditions in octal starting with machine condition set 
m for n sets. The integer m therefore represents a negative index from 
the last set of machine conditions stored (e.g., the request ".pmc 8 2" 
would be interpreted to mean, "display two sets of machine conditions 
starting from the last machine conditions stored at position 8"). If n is 
not specified, then all machine conditions starting at m to the last 
machine conditions stored are displayed. If neither m nor n are 
specified, all sets of machine conditions are displayed. 
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6. .pmci m n 

same as .pmc above except that the machine conditions are displayed in 
interpreted format. 

7. .pscu m n 

same as .pmc above except that only the System Control Unit (SCU) data 
for the specified number of machine conditions is printed, displayed in 
interpreted format. 

8. .hr m n 

displays history registers in octal, starting with history register set m for 
n sets. The variables m and n are defined as in .pmc above. 

9. .hrou m n 

same as .hr above except that only the Operations Unit (OU) history 
register is displayed in octal. 

10. .hrcu m n 

same as .hr above except that only the Control Unit (CU) history 
registers are displayed in octal. 

11. .hrdu m n 

same as .hr above except that only the Decimal Unit (DU) history 
registers are displayed in octal. 

12. .hrau m n 

same as .hir above except that only the Appending Unit (AU) history 
registers are displayed in octal. 

13. .hranl m n 

same as .hr above except that the specified number of history registers 
are displayed in interpreted format. 

14. .hrlgd 

produces a list of abbreviations used with the .hranl request above. 

The mc_trace command invokes a condition handler for the "any_other" condition. 
When any unusual system condition is encountered, a message indicating the condition 
that was raised is displayed on the error, output I/O switch, and control is passed to 
the request loop. At this time, any of the valid requests described above can be 
entered. For further information on system conditions, refer to the Programmer's 
Reference Manual, Order No. AG91). 

To use mc_ trace, you must have re access to phcs_. 
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EXAMPLES 

Assume that you have written a program that generates an op_not_complete fault while 
executing a csl (combine bit strings left) EIS instruction in a particular sequence (e.g., 
descriptors fall on page boundaries). This is clearly a hardware problem, but because it 
only occurs when a particular set of events take place, it is very difficult for the field 
engineer to trouble-shoot. For simplicity, call this program onc_csl. To run this 
program under control of mc_ trace, you execute the following sequence of commands: 

mc_trace onc_csl 

start trace with default buffer size of 5K words. 
— > . ,set_proc_requi red a 

run with only one processor, in this case processor a. 
--> • .onc_cs1 

execute the program onc_cs1 
op_not_complete condition raised, enter command. 

At this point, the op_not_complete condition has occurred, and the machine condition 
history for the last 103 machine conditions should be preserved in the machine 
condition buffer. You can now selectively display these machine conditions. 

— > ..set_proc_required 

reset set_proc_required (run on any processor now) 
— > ..file_output onc_ trace 

direct the output from the user_output I/O switch to the file named 

onc_ trace created in your working directory. 
— > .pmc 

display the entire machine condition buffer. In this case, the output goes 

to the onc_trace file. 
— > .pmci 

additionally display the machine conditions in interpretive format. 
— > .pscu 

also display only SCU data in interpretive format. 
— > .hr 1 

display history registers from last fault (in this case, the op_not_complete 

fault) in octal format. 
— > .hran] 1 

display a composite analysis of the last set of history registers. 
— > .hranl 2 1 

display a composite analysis of the next to last set of history registers. 
— > ..revert_output 

direct the output from the user_output I/O switch from the onc_trace 

file back to your terminal. 
— > ..dprint onc_trace 

print the onc_trace file on a remote printer. 
— > .q 

return to Multics command level. 
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If the op_not_coinplete fault does not occur on a consistent basis and it is suspected 
that it only occurs randomly when a particular sequence of page faults and interrupts 
occurs, you can use another program called "flush", which generates heavy paging 
activity, and can loop on these commands several times by executing the following line 
in place of the onc_csl command line: 

— > .rpt 99999999 f lush;onc_csl 
op_not_complete condition raised, enter command 
--> 

At this point, you can proceed as in the above example and print the machine 
conditions to a file or display them on the terminal. 

OUTPUT PRODUCED WITH THE .PMC, .PMCI , AND .PSCU REQUESTS 

.pmc REQUEST 

The .pmc request produces an octal dump of the machine conditions, separated by the 
logical data in the machine conditions (e.g., pointer registers, processor registers). The 
format is dependent on the state of the user_output I/O switch. If the user_output 
I/O switch is attached to a file or a terminal with a line length greater than or equal 
to 104 characters, then the output is formatted in lines of eight octal words per line. 
If the user_output I/O switch is attached to a terminal with a line length less than 104 
characters per line, then the output is formatted in lines of four octal words per line. 

MtitM(f\ach\r\& Conditions at mc_trace_buf f er | 2^10sV>'t*>'<* 

Pointer Registers 

0000350000i»3 O046i»6OOOO0O 000017000043 000000000000 
000062000043 005362000000 000135000043 000000000000 
000014000043 006712000000 000062000043 000000000000 
000062000043 004060000000 000356400043 000000000000 

Processor Registers 

011127005716 000000000031 060614000030 000015000720 

000000000012 000000000004 000000000000 001714442000 

SCU Data 

000113050202 000000000043 400356000004 000000540000 

044571000200 000000000400 700000100440 000140100540 

Software Data 

121040000012 420040000006 000000000000 000000000000 

000000000000 000000000000 000000104422 532243555724 

EIS Pointers and Lengths 

000400000000 000400000000 000000000070 004077777774 

000102000030 000000000000 030356000004 000000000077 
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.pmci REQUEST 

The .pmci request displays the machine conditions in an interpreted format, as shown 
below. 

**i<**t\ach\ne Conditions at mc_trace_buf f er |2iflO*>'t*** 

1*6^6 bound_sss_wi red_|i+6ii6 
sst_seg|0 

5362 pds 15362 
pr3 (bb) 135lO dirlockt_seg|0 



prO (ap) 


35 


prl (ab) 


17 


pr2 (bp) 


62 



pri* dp) K 
pr5 (lb) 62 
pr6 (sp) 62 



6712 as_l inkage|6712 



pds 
UO6O pds 




4060 



pr7 (sb) 35b|0 complex_decimal_op_|0 (bound_pl l_runt ime_|0) 



xO 11127 xl 5716 x2 x3 
xi» 6061^4 x5 30 x6 15 x7 
a 000000000012 q OOOOOOOOOOOlt e 
Timer reg - 17K4it2, Ring alarm reg - 

SCU Data: 



31 
720 



2it0 000113050202 0000000000^*3 i»oo356oooooit 000000540000 

044571000200 000000000400 700000100440 000140100540 

(DFl) Page Fault (43) 

By: 113|44571 bound_f i le_system| 44571 

Referencing: 356|0 complex_decima1_op_|0 (bound_pl l_runt ime_|0) 

On: cpu a (#0) 

Indicators: ''bar 

APU Status: sd-on, pt-on, ptw 

CU Status: rfi 

I nstructions: 

246 700000 100 440 mlr (rl) , () ,f i 1 1 (70O) 

247 000 140 100540 mlr (pr , r 1) , (pr , r 1) ,f i 1 1 (000) 

Time stored: 05/31/77 1355-3 mst Tue (104422532243555724) 
Ring: 

EIS Pointers and Lengths: 

260 000400000000 000400000000 000000000070 004077777774 
000102000030 000000000000 030356000004 000000000077 
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.pscu REQUEST 

The .pscu request displays only the SCU data from the machine conditions in an 
interpreted fashion, as shown below. 

j'o'o'cyoVMachi ne Conditions at mc_trace_buf |2AlO>'«*>'<>'c''< 

SCU data at ric_trace_buf |2itO 

240 000113050202 000000000043 400356000004 000000540000 

044571000200 000000000400 700000100440 000140100540 

(DF1) Page Fault (43) 

By: 113 I 44571 bound_f i 1 e_sy stem 1 44571 

Referencing: 356|0 comp1ex_decima1_op_|0 (bound_p1 l_runt ime_|0) 

On: cpu a (#0) 

Indicators: '^bar 

APU Status: sd-on, pt-on, ptw 

CU Status: rfi 

Instructions: 

246 700000 100 440 mlr (r 1) , () ,f i 1 1 (700) 

247 000 140 100540 mlr (pr , r 1) . (pr , r 1) ,f i 11 (000) 

OUTPUT PRODUCED BY THE .BR REQUEST 

The .hr request produces an octal dump of the history registers. The output is 
separated by the history register type being dumped. The format is dependent on the 
state of the user_output I/O switch. If the user_output I/O switch is attached to a 
file or a terminal with a line length greater than or equal to 104 characters, then the 
output is formatted in lines of eight octal words per line. If the user_output I/O 
switch is attached to a terminal with a line length less than 104 characters per line, 
then the output is formatted in lines of four octal words per line. If the .hrou, .hrcu, 
.hrdu, or .hrau requests are selected, only the requested history register type is dumped. 
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ftsVVitsV^Hi story Registers at mc_trace_buf |210***s'i* 



Operations Uni 



315000315100 
255000255300 
2200002213^0 
7400007^0300 
450000^*50300 
720000720500 
450000450300 
431210431100 

Control Unit 
700137352120 
200117352000 
700137352120 
200117352000 
600137621100 
200017431007 
300137370120 
300017352120 

Decimal Unit 
737757037737 
777757037737 
737757037737 
737757037737 
777757037737 
737757037737 
737757037737 
737757037737 



t (OU) Histo 

37777012705 

77777012710 

14777012717 
75777012721 
77777012725 
35777012727 
77777012731 
23777000052 



(CU) History 
000046050200 
027220050024 
000050050200 
027224050024 
000052050200 
020000042014 
027524050021 
034314042020 

(DU) History 

7ltlt2434l0017 
7/,1j243410017 
744243410017 
7i»it2434l0017 
744243410017 

71,42434 100 17 

744243410017 
741,243410017 



ry Registers 
450000450300 
221000221100 
220000220100 
741000741300 
446000446300 
440000440300 
621000621500 
431210431000 

Regi sters 

300117352120 

200017252100 

300137352120 

200017252100 

200117621100 

700137370120 

200117370000 

300005352046 

Registers 

737757037737 

737757037717 

777757037737 

737757037717 

737757037737 

777757037717 

777757037737 

777757037717 



177777012707 
136777012711 
135777012720 
176777012722 
177757012726 
175777012730 
122777000051 
037777000054 



027342050020 
027574242100 
027344050021 
027576242100 
027566050014 
000054042200 
034304050024 
034314402002 



744243410017 
744243410017 
744243410017 
744243410017 
744243410017 
744243410017 
744243410017 
744243410017 



Appending Un 
002342006066 
002342006066 
002342006066 
002342006066 
002342006066 
003576001420 
003576007262 
002556001420 



it (AU) Histor 
027555724775 
027553424775 
027555744775 
027553444775 
027555764775 
000275664775 
024520544775 
000343044775 



y Registers 

003576007262 

002346001420 

003576007262 

002346001420 

003576007262 

003576001420 

002342006066 

002552007370 



024520464775 
000272204775 

024520504775 
000272244775 

024520524775 
000200004775 
027555244775 
026403144000 
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OUTPUT PRODUCED BY THE .HRANL REQUEST 

The .hranl request produces a composite analysis of the history registers in the trace 

buffer. The output produced is dependent on the state of the user_output I/O switch. 
If the user_output I/O switch is attached to a terminal with a line length less than 104 

characters, the output appears as below. If the user_output I/O switch is attached to a 

file or a terminal with a line length greater than or equal to 104 characters, then the 
octal representation of the history registers is displayed in addition to the sample below: 

j'o'tAs'sjVHi story Registers at mc_trace_buf 1 210''tjVVc)'c* 
Composite Analysis of History Registers 

offset mc flags 

^+6 h p\ pa r i i c wi it 

3360U6 h ap sm pm 

273^2 h pa ri ic it cl 

5333^2 k ap sm pm 

27220 k pa ic c! dr 
27220 k 

2757^ 2i* pa i t cs 

53357'* ^ ap sm pm 

50 4 pi pa r i ic wi it 

336050 h ap sm pm 

ITihU U pa ri ic wi it cl pb 

5333'*'* ^ ap sm pm 

27224 k pa ic cl dr 
27221* U 

27576 21» pa it cs 

533576 k ap sm pm 

52 it pi pa i c wi it 

336052 U ap sm pm 

27566 l» pa ic it ol dr 
27566 i» 

rb rs of -d ar qr xl 

20000 U pa ol dr 
20000 k 

dl rs of -d ar qr 

54 4 pi pa r i i c wi it 

336051+ h ap sm pm 

2752lt It pa r i ic wi it cl pb 

533524 4 ap sm pm 

43742 4 pa ic cl dr 
43742 4 

43752 4 pa ri it cl 

3225752 4 ap sm pm 



HR 






c 




i d## 1 C oDcd 


tag 


. y 


seg# 


CU 1 


epp2 


r\* ~ 


i 


415 


AU 2 








7 6 


CU 2 


II 


n>v 


n 


234 


AU 3 








12 5 


CU 3 


II 




d 


234 


AU 4 










CU 4 


46 spri2 







234 


AU 5 








12 5 


CU 5 


47 epp2 


n* 


i 


415 


AU 6 








7 6 


CU 6 


II 


n* 


n 


234 


AU 7 








12 5 


CU 7 


II 




d 


234 


AUlO 










CUIO 


50 spri2 







234 


AUll 








12 5 


CUll 


51 eaxl 




i 


415 


AU12 








7 6 


CU12 


II 




d 


415 


AUI3 










OUI6 










CUI3 


52 fid 


dl 


d 


415 


AU14 










OUI7 










CU14 


53 epp4 


ns'c 


i 


415 


AUI5 








7 6 


CUI5 


II 


nvc 


n 


234 


AU16 








12 5 


CU16 


II 




d 


255 


AUI7 










CUI7 


54 apwl 


n* 


n 


255 


AU20 








4 4 
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OUTPUT PRODUCED BY THE .HRLGD REQUEST 



The .hrlgd request produces a list of the abbreviations used with the .hranl request 
above. 



Abbreviations used in History Register Analysis 



_CU Legend_ 



cy = cycle type (d = direct operand) 
(i = i nstr . f etch, o=oper and, F=f aul t) 
(n=indi rect,x=xec,*=nop,e=E I S) 
mc = memory command 
(00=rrs,sp; 04=rrs,dp; 10=rcl,sp) 
(12=rmsk,sp; l6=rmsk,dp; 20=cwr,sp) 
(24=cwr,dp; 32=smsk,sp; 36=smsk,dp) 
(40=rd/lck; 5i»=rgr; 56=sgr) 
(60=wrt/ulck; 62=con; 66=xec; 72=sxc 
»>f lags«< 

-y = memory address invalid 
br = BAR mode 
cl = control unit load 
cs = control unit store 
dr = direct operand 
fa = prepare fault address 
ic = IC value is odd 
it = AR/PR reference 
in = inhibited instruction 
ol = operations unit load 
OS = operations unit store 
pa = prepare operand address 
pb = port busy or data from cache 
pi = prepare instruction address 
pi = port select logic not busy 
pn = prepare final indirect address 
pt = prepare operand tally 
ra = request alter word 
ri = request indirect word 
rp = executing repeat 
sa = store alter word 
si = store indirect word 
tr = transfer condition met 
wi = request instruction fetch 
xa = prepare execute interrupt addre 
xe ■ execute double from even I CT 
xi =■ execute interrupt present 
xo = execute double from odd I CT 



_0U Legend_ 



»f lags«< 

9b = 9"bit byte (IT modifier only) 

ar = A-register in use 

dl = first divide cycle 

d2 = second divide cycle 

dl = direct lower operand 

du = direct upper operand 

in = first ou cycle 

it = IT character modifier 

oa = mantissa alignment cycle 

oe = exponent compare cycle 

of * final OU cycle 

om " general OU cycle 

on = normalize cycle 

OS " second cycle of multiple ops 

qr = Q-register in use 

rb = opcode buffer loaded 

rp = primary register loaded 

rs = secondary register loaded 

sd = store data available 

-d = data not available 

xO = i ndex i n use 

xl " index 1 in use 

x2 = index 2 in use 

x3 = i ndex 3 ' n use 

Y.k = index k in use 

x5 = index 5 in use 

x6 = index 6 in use 

x7 = index 7 in use 



ss 
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_DU Legend_ 



mc = data mode (b,^,6,9,w) 
offset = descriptor counter 
»>f lags«< 

a = prepare alignment count for 

numeric operand (1 ,2) 
a() = load alpha operand (1,2) 
al = adjust length 
as = alpha store 
bd = binary-decimal execution 

bg = blanl<ing gate 

cO = force stcO 

eg = character operation 

d = descriptor active (1,2,3) 

da = data aval lable 

db = decimal -bi nary execution 

dd = decimal unit idle 

di = decimal unit interrupted 

dl = decimal unit load 

ds « decimal unit store 

ei = mid-instruction interrupt ena 

en = end instruction 

es = end sequence 

ff = floating result 

fl = first data buffer load 

fp = first pointer preparation 

fs = end sequence 

1 = load descriptor (1,2,3) 
Id = length = direct 

If = end first pointer preparation 

Iv = level < word size 

Ix = length exhaust 

1< = length < 128 

mp = executing MOPs 

n = load numeric operand (1,2) 

nd = need descriptor 

ns = numeric store 

op = operand available 

pc = alpha packing cycle 

pi = prepare operand length 

pp = prepare operand pointer 

r = load rewrite register (1,2) 

re = write-back partial word 

rf = rounding 

rl = rewrite register 1 loaded 

rw = du=rd+wt control interlock 

sa = select address register 

sg = shift procedure 



seg# 



APU Legend 

SDWAMR and PTWAMR numbers if 



corresponding MATCH bits are set. 
offset = final store address 
mc = ring number (TSR.TRR) 

»>f lags«< 

an ■ final address, non-paged 

ap = final address, paged 

f = access violation or directed 

fault 
fd = fetch descriptor segment PTW 
f h = faul t wai ti ng 
fs = fetch SDW 

md = modify descriptor segment PTW 
mp = modify PTW 
pi = fetch PTW 
p2 » fetch PTW+1 
pm - MATCH in PTWAM 
sm - MATCH in SDWAM 

bled 



DU Legend 

xg = exponent network 
xm = extended al,ql modifier 
+g = add-substract execution 
>'<g = mul tiply-divide execution 
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Name: mos ^edac summary 

SYNTAX AS A COMMAND 

mos_edac_sutiiniary {-control_args} 

FUNCTION 

scans the syserr log and summarizes mos edac activity in a brief report. 

CONTROL ARGUMENTS 

-day_limit N 

sets a threshold of N days that a memory chip can fail before including it in the 
summary. The maximum value for N is 16. 

-for T 

specifies a relative time (such as "1 hour") used to compute the ending time from 
the starting time. 

-from DT, -fm DT 

specifies the date /time to start scanning the log. 

-limit N 

sets a threshold of N edac errors for a memory chip before including it in the 
summary. 

-mem list 

specifies a list of memories for which information is required (i.e., mem a b c). 

-to D 

specifies the date/ time to stop scanning the log. 

Notes 

If -from DT is not specified, the scan starts with the earliest message in the 
syserr log. The ending time may be specified by using -for, or -to, but not both. If 
both are omitted, the scan terminates which the last message in the log. All dates and 
times must be in a format acceptable to convert_date_to_binary_ described in the 
Subroutines manual. 



You must have re access to audit_gate_ and r access to the permanent_syserr_log 
segment to use this command. 
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Name: mpc data summary 

SYNTAX AS A COMMAND 

mpc_data_summary {list} {-controI_args} 

FUNCTION 

scans the syserr log and summarizes the MPC statistics placed there by poll_mpc. 

ARGUMENTS 

list 

is a list of MPC controller names that the data is to be summarized for (i.e., mspa 
mtpb urpa). The MPC controller names must be four characters long, and the first 
three characters must be msp, mtp, or urp. The default list is of all MFCs found 
in the log. 

CONTROL ARGUMENTS 

-all 

reports all MPCs found in the syserr log. 

-brief, -bf 

reports only nonzero device statistics. 

-expand 

expands each syserr log entry that is used for the summary. This may cause much 
output. 

-extend, -ext 

extends the output file if it exists. The default is to overwrite the file. 

-for T 

computes the ending time from the starting time, where T is a relative time (such 
as Ihour or Iday). 

-from DT, fm DT 

starts scanning the log at the date/ time given. 

-long, Ig 

reports all device statistics. (Default) 

-mpc list 

displays MPC error data only. 

-output_file {path}, -of {path} 

directs output to the segment specified by path. If path is not given, a default 
segment is used in the working directory and named mpc_data_summary.output. 
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-short 

formats output for devices with fewer than 132 columns. The default is based on 
output file type and can be used to override the file output default. 

-to DT 

stops scanning the log at the date/ time given. 



Name: patch firmware 

SYNTAX AS A COMMAND 

patch_f i rmware path mem addr wordl . . .word2. . .word! 

FUNCTION 

patches a segment containing an image of a firmware module for an MPC. 

ARGUMENTS 

path 

is the pathname of the segment containing the firmware. 

mem 

is the memory overlay to patch. This argument can be cs to patch the control 
store overlay, or rw to patch the read/write memory overlay. 

addr 

is the starling address to patch, in hexadecimal. 

wordi 

is a new MPC word, in hexadecimal. All wordi arguments must be in the range 
0-FFFF. At least one wordi argument must be specified. Up to 16 words can be 
patched with one patch_firmware command. 

NOTES 

The patch_firmware command displays the old and new contents of each firmware word 
patched, as well as the checksum, before the patch is made. The user is then asked 
whether the patch is correct. The patch is not made unless you answer yes. 

Firmware modules can be retrieved from the IFAD tape using the load_tandd_library 
command (described in the Online T&D manual). Normally, firmware modules are kept 
in the sequential file >system_library_tandd>tandd_deckfile. 
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Name: poll_fnp 

SYNTAX AS A COMMAND 

pol l_fnp {fnp_list} {-control_args} 

FUNCTION 

initiates and controls automatic polling of FNPs. Polling consists of reading error 
statistics from the FN? memory and logging them in either the syserr log or a file. 
This command sets up timers and event call handlers within the process. Once initiated, 
FN? polling is performed periodically, independent of whatever else is going on in the 
process. This command is normally used by the initializer or a daemon. 

ARGUMENTS 

fnp_list 

is a list of the FNP names to be polled. If no names are listed, all FNPs are 
polled. 

CONTROL ARGUMENTS 

-log 

writes statistical information to the syserr log. This is the default. Access to the 
hphcs_ gate is required. 

-output_file path, -of path 

writes statistical information to the segment specified by path. This control 
argument can be used in conjunction with -log. 

-time N, -tm N 

specifies the polling interval in minutes. The default polling interval is 15 minutes. 

-debug, db 

prints extra debugging information each time polling is performed. 

The following control arguments modify the polling already in process and cannot be 
used on the initial invocation of the poll_fnp command. 

-stop, -sp 

stops polling for the FNPs specified with the fnp_list argument. If no FNPs have 
been specified, polling of all FNPs is stopped. Polling continues to be scheduled 
periodically, even though no FNPs are being polled. 

start, -sr 

resumes polling for the FNPs specified with the fnp_list argument. If no FNPs 
have been specified, polling of all FNPs is resumed. Note that the next polling 
does not occur immediately; it is performed during the next scheduled polling 
cycle. 
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-finish 

schedules the last polling cycle immediately. Once this cycle completes, polling is 
disabled, and a new poll_fnp command is required to start it again. To stop 
polling without performing one last cycle, use both -stop and -finish. 

NOTES 

If polling of an individual FNP fails three consecutive times, polling of that FNP is 
slopped. If three consecutive scheduled polling cycles are missed because a previous 
cycle did not complete, an automatic finish operation is performed, and no further 
cycles are scheduled. 

Polling of FNPs has no effect on the users of devices connected to the FNP. 



Name: poll mos memory 

SYNTAX AS A COMMAND 

pol l_mos_niemory 

FUNCTION 

reads the maintenance register of each memory on the system and prints information 
about these registers on your terminal. In addition, if the maintenance register indicates 
that an EDAC error has occurred, it is logged in the syserr log. 

NOTES 

You must have re access to phcs_ to use this command. 

This command should be used with care on systems that have core memories. Unless 
the TEST/NORMAL switch on the maintenance panel of the memory (not controller) is 
set to TEST, the result of reading the maintenance register is undefined, and spurious 
errors may be logged. 
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Name: poll mpc 

SYNTAX AS A COMMAND 

po11_nipc {mpc_list} {-contro1_args} 

FUNCTION 

initiates and controls automatic polling of MFCs. Polling consists of reading statistics 
on device usage and errors from the MPC memory and logging it in either the syserr 
log or a file. If an error condition is detected, a message is entered in the syserr_log 
with a code of 3. This sounds the BOS console alarm and prints the message on the 
BOS console log on a normally configured system. This command sets up timers and 
event call handlers within the process. Once initiated, MPC polling is performed 
periodically, independent of whatever else is going on in the process. This command is 
used by the initializer or a daemon; Utility. SysDaemon is recommended. 

ARGUMENTS 

mpc_list 

is a list of the tape or disk MPC names to be polled. If no names are listed, all 
tape and disk controllers are polled. 

-log 

writes statistical information to the syserr log. Access to the hphcs_ gate is 
required. (Default) 

output_file path, -of path 

writes statistical information to the segment specified by path. This report is the 
same as the one generated by the -stat control argument of the dump_mpc 
command. This control argument can be used in conjunction with -log. 

-time N, -tm N 

specifies the polling interval in minutes. The default polling interval is 15 minutes. 

-debug, -db 

prints extra debugging information each time polling is performed. 

The following control arguments modify the polling already in process and cannot be 
used on the initial invocation of the poll_mpc command. 

-stop, -sp 

stops polling for the MPCs specified with the mpc_list argument. If no MFCs 

have been specified, polling of all MPCs is stopped. Polling continues to be 

scheduled periodically, even though no MPCs are being polled. 
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-start, -sr 

resumes polling for the MFCs specified with the inpc_list argument. If no MFCs 
have been specified, polling of all MFCs is resumed. Note that the next polling 
does not occur immediately; it is performed during the next scheduled polling 
cycle. 

-finish 

schedules the last polling cycle immediately. Once this cycle completes, polling is 
disabled, and a new poll_mpc command is required to start it again. To stop 
polling without performing one last cycle, use both -stop and -finish. 

NOTES 

If polling of an individual MFC fails three consecutive limes, either because it cannot 
be attached or because of I/O errors, polling of that MFC is stopped. If three 
consecutive scheduled polling cycles are missed because a previous cycle did not 
complete, an automatic finish operation is performed, and no further cycles are 
scheduled. 

Polling of MFCs has no effect on the users of devices connected to the MFC. 



Name: print_configuration deck, pcd 

SYNTAX AS A COMMAND 

pr i nt_conf i guration_deck {card_naines} {-control_args} 

FUNCTION 

displays the contents of the Multics configuration deck. The data is kept up-to-date by 
the reconfiguration commands and, hence, reflects the current configuration being used. 

SYNTAX AS AN ACTIVE FUNCTION 

[pcd {card_names} {-control_args} ] 

ARGUMENTS 

caTd_names 

are the names of the particular configuration cards to be displayed. Up to 32 card 
names can be specified. (See the MOH, for the names of the configuration cards.) 

CONTROL ARGUMENTS 

-brief, -bf 

suppresses the error message when a requested card name is not found. (Default) 
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-exclude FIELD.SPECIFIERS, -ex FIELD_SPECIFIERS 

excludes particular cards or card types from being displayed. One to 14 field 
specifiers can be supplied with each -exclude, and up to 16 -exclude control 
arguments can be specified. To be eligible for exclusion, a card must contain fields 
that match a:il field specifiers supplied with any -exclude argument. 

-long, -Ig 

prints an error message when a requested card name is not found. 

-match FIELD_SPECIFIERS 

selects particular cards or card types to be displayed. One to 14 field specifiers 
can be supplied with each -match, and up to 16 -match control arguments can be 
specified. To be eligible for selection, a card must contain fields that match all 
field specifiers supplied with any -match argument. 

-pathname PATH, -pn PATH 

prints card(s) from the copy of the configuration deck at PATH, rather than the 
one for the running system. 

NOTES 

Field specifiers can consist of a complete card field or a partial field and an asterisk 
(*). An asterisk matches any part of any field. For example, the field specifier "dsk*" 
would match any card containing a field beginning with the characters "dsk". Specifiers 
for numeric fields can be given in octal or decimal, but if decimal they must contain a 
decimal point. Asterisks cannot be specified in numeric field specifiers. All numeric 
field specifiers are converted to decimal and matched against numeric card fields, which 
are also converted to decimal. Hence, the field specifier "1024." would match a card 
containing the octal field 2000, and the field specifier "1000" would match a card 
conuining the decimal field 512. 

Selection is performed as follows. If no card names are specified, all cards are eligible 
for selection. On the other hand, if any card names are supplied, only the cards 
matching those names are eligible; and if more than one card exists with a specified 
name, all such cards are displayed. If a nonexistent card is requested, and the -long 
control argument is specified, an error message is displayed. 

If any -match arguments are supplied, those eligible cards are matched against all field 
specifiers of each -match argument group; however, at least one -match group must 
have all its field specifiers match some field on the card to make that card eligible. A 
similar algorithm is used for any -exclude argument groups. So, if a card is eligible, 
and if -exclude arguments are supplied, then at least one -exclude group must have all 
its field specifiers match some field on the card to make that card ineligible. If no 
match for a given card name or -match group is found in the config_deck, nothing is 
displayed for that name or group, and no error is displayed. If no arguments are 
present, the complete config_deck is displayed. 

Note that all card names must be specified before the first -match or -exclude 
argument. Field specifiers following a -match or -exclude argument include all 
arguments until the next -match or -exclude argument. 
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When called as an active function, the selected cards are returned in quotes, separated 
by a single space. 

No action is taken for misspelled arguments or valid arguments for which there are no 
corresponding configuration cards. 

EXAMPLES 

! pcd cpu 

cpu a 7 168 80. on 

cpu b 6 168 80. on 

cpu c 5 168 80. off 

(For the configuration deck displayed above.) 

! pcd cpu -match on 

cpu a 7 168 80. on 
cpu b 6 168 80. on 

! pcd -match 16 -ex off -ex b 
cpu a 7 168 80. on 



Name: print syserr log 

SYNTAX AS A COMMAND 

pr i nt_syserr__log {-control_args} 

FUNCTION 

prints selected portions of the syserr log. 

CONTROL ARGUMENTS 

-pathname path, -pn path 

where path is the pathname of the segment to be used. The default is to use the 
perm_syserr_log. 

The following control arguments determine which portions of the log are printed. If 
none are given, the entire log is printed. They can be chosen from any of these three 
groups: 
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The following control arguments specify the range of the log to be scanned: 

-from DT, -fm DT 

where DT is a decimal integer or a date/ time. This argument specifies the starting 
point of the scan. If DT is an integer, it represents a sequence number; otherwise, 
it represents a date and time. 

-to DT 

where DT is a decimal integer, or a date/time. This argument defines the ending 
point in the scan by sequence number or time. 

-for DT, -next DT 

where DT is a decimal integer or a date/ time. If a date/ time is used, it must be 
a relative time (such as "1 day") that specifies how far from the starting point to 
scan the log. 

-last N 

where N is a decimal integer. This argument specifies that the scan is to start N 
messages back from the end of the log. 

The starting point is specified by either -from or -last, but not both. If both are 
omitted, the scan starts at the earliest recorded message. The ending time is specified 
by -to or -for(-next), but not both. If both are omitted, the scan ends with the most 
recent message in the log. Date/ time arguments used with -from, -for, or -to must be 
in a format acceptable to convert_date_to_binary_, described in the Subroutines manual. 

The following control arguments specify which messages in the range scanned are to be, 
or not to be, printed: 

-match STRl ... STRn 

where STRi are strings to be matched against messages in the log. Any message 
that contains an STRi is a candidate to be printed. 

-exclude STRI ... STRn. -ex STRI ... STRn 

where STRi are strings that are matched against the log, as for -match. Any 
message that contains an STRi is not printed. (Therefore, any message that does 
not contain an STRi is a candidate to be printed.) 

-action Al ... An 

where Ai are decimal integers in the range to 9. If this argument is used, only 
messages with an action code specified by an Ai are candidates to be printed. 

-class CI ... Cn, -cl CI ... Cn 

where Ci are decimal integers in the range to 24. If this argument is used, only 
messages with a sorting class specified by a Ci are candidates to be printed. 

If none of these control arguments are used, all messages in the range are printed. If 
some of the above control arguments are used, only messages that pass all these tests 
are printed. 
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The following control arguments specify the format of the messages printed. 

-no_header, -nhe 

specifies that the header that contains the range of the log under consideration is 
not printed. 

-expand 

sfttcifies that messages that have binary data will have that binary data interpreted. 
The format is generally dependent on the text of the message. 

-octal 

specifies that all messages that have binary data will have that binary data printed 
in octal. 

-limits 

specifies that the command is only to read the first and last messages in the log 
and print their times and sequence numbers. No other action is performed, 
regardless of what other control arguments are used. 

-debug, -db 

inhibits all expanding of "«" messages in the log. All messages are printed exactly 
as they appear in the log. 

NOTES 

You must have re access to audit_gate_ and r access to the permanent_syserr_log 
segment to use this command. 

EXAMPLES 

To print the entire log, type: 

pr i nt_syserr_log 

The command line: 

pr i nt_syserr_1og -match "parity Fault" -ex SysDaemon -expand 

scans the entire log and prints all messages containing the string "parity fault" that do 
not contain the string "SysDaemon". The binary data logged with these messages is also 
printed. The result of this command is to print all parity faults logged by other than 
SysDaemon processes. 
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To see the messages for a certain time period that contain a particular string, use a 
command hne of the form: 

pr int_syserr_log -from "2/1/78 0000.0" -to "2/1/78 2i400.0" 
-match RCP: 

The -to control argument in this example could have been replaced by -for "1 day". 
All messages logged on 2/1/78 containing the string "RCP:" are printed. • 

The command line: 

pr int_syserr_log -last 500 -class 2 -nhe 

scans the last 500 messages in the log and prints out any messages with a sorting class 
of 2. This example also suppresses the header. 



Name: save history registers 

SYNTAX AS A COMMAND 

save_history_registers {state} {-control_args} 
FUNCTION 

allows a user to save processor history registers upon each occurrence of a signalable 
fault in the signalers stack frame. By default, the history registers are not saved, and 
the history register block in the signalers stack frame is set to all zeros. 

ARGUMENTS 

state 

can be either "on" or "off." If state is not specified, it is off. 

CONTROL ARGUMENTS 

-priv 

specifies manipulation of the per-system state by directing the state and -print 
arguments to operate on the per-system history register save switch, 
wired_hardcore_data$global_hregs. When set, this switch causes all processes to save 
their history registers upon each occurrence of a signalable fault in the signalers 
stack frame. If -pri\' is not specified, then the state and -print arguments operate 
on pds$save_history_regs, the per-process history register save switch of your 
process executing this command. 

-print, -pr 

displays the current state of the history register save switch if it is present without 
the state argument: with this argument, the state of the switch is displayed before 
the new state is applied. 
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NOTES 

When -priv is used, hphcs_ access is required. 



Name: set mos__polling time 

SYNTAX AS A COMMAND 

set_nios_pon i ng_time {N} 

FUNCTtON 

sets the time interval used by the system for polhng MOS memories to check for and 
log EDAC errors. 

ARGUMENTS 

N 

is a decimal integer representing the time in minutes between MOS memory polls. 
If omitted, the command prints the current polling interval. If N is 0, MOS 
memory polling is disabled. 

NOTES 

MOS memory polling is disabled when the system is initialized. This command must be 
used to enable it. 

You must have re access to hphcs_ to use this command. 

MOS memory polling should not be enabled on systems that have core memories unless 
the TEST/NORMAL switch on the maintenance panel of the memory {not controller) is 
set to TEST. If this switch is set to NORMAL, spurious errors may be logged for the 
memory. 



Name: set proc required, sprq 

SYNTAX AS A COMMAND 

set_proc_required {tagl} . . . {tag2} . . . {tagi} {-control_args} 

FUNCT/ON 

restricts processes to run only on specified CPUs. It can be used to specify the set of 
CPUs on which the invoking process can be run and the default set of CPUs for all 
processes that have not requested specific CPUs. 
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ARGUMENTS 

tagi 

is the tag for one of the CPUs in the group being specified. It can be one of the 
letters a through h or A through H. If no tag is specified, the group is assumed 
to contain all CPUs (tags A through H). If -priv is given, then at least one tag is 
required. 

CONTROL ARGUMENTS 

-priv 

indicates that the group of CPUs specified is to become the default group for 
processes that have not requested specific CPUs. If omitted, the group of CPUs 
specified applies only to the invoking process. 

NOTES 

If none of the CPUs specified are online, an error message is printed, and the 
command has no effect. 

This command requires access to phhcs_. If the -priv control argument is specified, 
access to hphcs_ is needed. 

EXAMPLES 

The command line: 

set_proc_requi red A B 
restricts the requesting process to run only on CPUs "A" and "B." 
The command line: 

set_proc_requi red 
allows the requesting process to run on any CPU that is online 
The command line: 

set_proc_requi red ABE -priv 

restricts all processes that have not requested specific CPUs to run only on CPUs "A." 
"B," and "E." 

The command line: 

set_proc_required -priv 

allows all processes that have not requested specific CPUs to run on any CPU that is 
online. 
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Name: test cpu 

SYNTAX AS A COMMAND 

I test_cpu {-contro1_args} 

FUNCTION 

checks the CPU hardware for problems that have existed on the processors. By running 
various tests invoked by this command, you can determine whether the given CPU has 
had specific problems fixed. This command is usually used with the set_proc_required 
command if the system being tested has multiple CPUs configured. 

CONTROL ARGUMENTS 

-from TEST NUMBER/NAME, -fm TEST NUMBER/NAME 

starts testing from the test identified by TEST NUMBER or NAME. The default is 
to start testing from test 1. 

-to TEST NUMBER/ NAME 

stops testing after the test identified by TEST NUMBER or NAME. The default is 
to run all tests. 

-test_names 

lists valid , test names and the associated test numbers. 

-exclude TEST_LIST, -excl TEST_LIST 

excludes the tests identified by TEST_LIST. where TEST_LIST is either a set of 
test names or numbers, from the tests that are run. 

-stop_on_failure, -sof 

stops testing when a test failure occurs. The default is to continue testing with the 
next test. 

-long. -Ig 

displays machine conditions and history registers from a test failure. The default is 
not to display them. 

-history_regs, -hregs 

displays history registers when a test fails. The default is not to display them. 

-machine_conditions, -mc 

displays machine conditions when a test fails. The default is not to display them. 

-brief, -bf 

inhibits display of the test numbers. The default is to display the test number and 
name as each test begins execution. 

-repeat COUNT, -rpt COUNT 

repeats the test sequence the number of times specified by COUNT. The default is 
to run the test set one time. 
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-cycle COUNT 

cycles on each test case the number of times specified by COUNT. The default is 
to run each test once. 

-select TEST_LIST, -sel TEST_LIST 

executes only those tests specified by TEST_LIST, where TEST_LIST may be either 
a valid test number or a name. The default is to run all tests. 

-select TESTNAMEl... {TESTNAME2} ... {TESTNAMEi} , 

-sel TESTNAMEl... {TESTNAME2} ... {TESTNAMEi} is the name of a diagnostic test. If 
no test names are given, all tests are run and any failures are noted. If more than 
one test name is given, a list of all the tests is printed. The tests are described 
briefly below. To find out the exact deuils of each test, see the test_cpu program. 

DIAGNOSTIC TESTS 

mlrstern 

checks a failure in which the fill character is placed as the first character on a 
page. This test causes a MMEl fault if the hardware fails. 

tmlr 

tries several MLR instructions, in several working combinations, across a page 
boundary. Messages are printed for any failures. 

csLoob 

checks a particular use of a CSL instruction where the first descriptor is 0. This 
test causes an out_of_bounds fault if the hardware fails, and a MMEl fault if it 
succeeds. 

mvn 

checks the use of an MVN instruction that moves a number to a shorter number. 
The first two characters are dropped when the hardware fails. 

mvn_ofl 

checks the use of MVN to move the number 0. An overflow indicates that the 
hardware failed. 

let 

checks a particular TCT use. The test causes an op_nol_complete if the hardware 
fails, and a MMEl fault if it succeeds. 

sreg 

checks the use of an SREG instruction that occurs as the last instruction in a page. 
The test causes an op_not_complete if the hardware fails, and a MMEl fault if it 
succeeds. 

csl_onc 

checks a particular CSL use. The test causes an op_not_complete if the hardware 
fails, and a MMEl fault if it succeeds. 



2-103 AR97-03 



test_cpu test_cpu 



test_sc2 

checks the use of the SC modifier interacting with page faults. A MMEl fault 
occurs if the hardware fails. 

test_ci 

checks the use of the CI modifier interacting with page faults. A MMEl fault 
occurs if the hardware fails. 

rpd_test 

checks a particular use of the RPD instruction as it interacts with the hardware. A 
MMEl fault occurs if the hardware fails. 

mlr_test 

checks the use of the MLR instruction across a bounds fault boundary. The bounds 
fault is followed by a segment fault and a page fault. A MMEl fault occurs if 
the hardware fails. 

cls_lest 

checks the CSL instruction across a bound fault boundary. A MMEl fault occurs 
if the hardware fails. 

cmpc 

checks the CMPC instruction in a way that fails if a timer runout or connect fault 
occurs in midexecution when the hardware is failing. A MMEl fault occurs if the 
hardware fails. 

bad_fill 

checks the success of moving or comparing fill characters in the first two words of 
a page. Failure is indicated by a miscompare and a message to the user. 

nipy_ofl 

multiplies -2**35 by itself and checks for an overflow fault (which indicates 
failure). 

test_xed 

checks a particular indexed XED usage that fails if the first executed instruction is 
an APU-type instruction. Failure is indicated by a miscompare and a message to 
you. 

cmpc7 

checks a CMPC failure when both strings begin seven words from a page boundary 
and run into the next page. A MMEl fault occurs if the hardware fails. 

extra_fill 

checks the MLR instruction to see if extra fill characters are placed after a string 
when the string crosses a page boundary. A MMEl fault occurs if the hardware 
fails. 

test_cmpc_fill 

checks the fill mechanism of the CMPC instruction near a page boundary. A 
MMEl fault occurs if the hardware fails. 
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acv_restart 

checks that machine conditions can successfully be restarted after an access 
violation fault that is caused by a reference to data via an EIS (MLR) instruction. 
Failure is indicated by successive no_write_permission conditions. 

scm_tally 

checks to see if the SCM instruction works with the tally runout indicator set 
correctly. The test calls a small aim program that uses an SCM instruction. 
Because the hardware fails erratically, the test is run 10 times to get a (limited) 
statistical sampling. Failure is indicated by a message to you indicating the number 
of times the SCM instruction failed. 

mvt_nine_to_six 

checks nine to six (ascii to bed) conversion using the MVT instruction. A large 
ascii data segment is generated. Then a bed segment is generated using non-EIS 
conversion. Three segments are then converted from ascii to bed using the MVT 
instruction, and these segments are compared to the known good bed segment. If 
any compare errors are detected, the contents of both segments are dumped in 
octal at the failing location. 

mvt_six_to_nine 

checks six to nine (bed to ascii) conversion using the method described for the 
mvt_nine_to_six test above. If any compare errors are detected, the contents of 
both segments are dumped in octal at the failing location. 

mvt_nine_to_four 

checks 9-bit to 4-bit (decimal to packed decimal) conversion using the MVT 
instruction. A large segment of data, containing 9-bit characters of values to 15 
in a rotating pattern, is generated. Then a second segment is generated, converting 
the 9-bit characters into 4-bit characters using non-EIS conversion techniques. The 
9-bit data segment is then converted to three 4-bit data segments using the MVT 
instruction and compared to the known good 4-bit data. If any discrepancies are 
found, the contents of both segments are dumped in octal at the failing location. 

mvt_four_to_ntne 

checks 4-bit to 9-bit (packed decimal to decimal) conversion using the method 
described for the mvt_nine_to_four test above. If any compare errors are found, 
the contents of both segments are dumped in octal at the failing location. 

mvt_ascii_to_ebcdic 

checks nine to nine (ascii to ebcdic) character conversion using the method 
described for the mvt_nine_to_four test above. If any discrepancies are found, the 
contents of both segments are dumped at the failing location. 

m\'t_ebcdic_to_ascii 

checks nine to nine (ebcdic to ascii) character conversion using the method 
described for the mvt_nine_to_four test above. If any discrepancies are found, the 
contents of both segments are dumped in octal at the failing location. 
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ci_mod_case_2 

checks character indirect modification with two tally words and two data character 
strings, each located at a page boundary. An LDA instruction is executed on one 

tally word, CI mod, and a CMPA is executed with a second tally word, CI mod. 

Both tally words point to a character string that should be equal. If the zero 

indicator does not come on as a result of the CMPA, a MMEl fault is taken, 
indicating that the hardware failed. 

acv_restart_csl 

validates that machine conditions can be successfully restarted after an access 
violation fault that is caused by a reference to data via an EIS (CSL) instruction. 
Failure is indicated by successive no_write_permission conditions. 

cmpn_tst 

checks that numeric data moved with an MVN instruction can be successfully 
compared with a CMPN instruction. Failure is indicated by a MMEl fault. 

itp_mod 

checks that an EPP2,* to a word pair that contains an ITP modifier with a bit 
offset actually loads PR2 with the correct information. A MMEl fault indicates 
failure. 

mvnoosb 

checks the prepage logic of the CPU for EIS numeric instructions. Failure is 
indicated by a MMEl fault. 

cmpb_with_sixbit_offset 

checks the CMPB instruction with a six bit offset. A MMEl fault indicates that 
the hardware failed. 

cmpb_with_rotate 

checks the CMPB instruction with a rotating pattern. A MMEl fault indicates that 
the hardware failed. 

cmpc_pgbnd 

compares a 38-character data string against a zero-length string, for a CMPC 
instruction that is located at seg|1767. Either an out_of .bounds condition or a 
MMEl fault indicates that the hardware failed. 

csLpgflt 

checks that a CSL instruction does not get a no_write_perm condition if it causes 
a page fault on the target string and the source string is read-only. 

scm_pgfll 

tests a problem with the SCM instruction whereby the target operand takes a page 
fault and the resulting comparison is not made. Failure is indicated by a message 
to you indicating the number of miscompares. 

scd_con_flt 

tests a failure with the SCD instruction that fails when interrupted by a connect 
fault. Failure is indicated by displaying the number of times the SCD failed. 
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Name: test dew 

SYNTAX AS A COMMAND 

test_dcw {device} {name} {-control_args} 

FUNCTION 

constructs and executes arbitrary DCW lists on any device supported by the I/O 
interfacer. 

ARGUMENTS 

device 

is the name of the device to be used. This can be either a specific device name, 
such as "tape_02" or "puna," or a generic device type, such as "printer" or "disk." 
If the device name is omitted, "tape" is assumed. 

name 

is the name of the tape or disk volume to be mounted. This argument is only 
used if the device is a tape or a disk, and is the name of the volume the operator 
is requested to mount. If the tape or disk volume name is omitted, "scratch" is 
assumed. 

CONTROL ARGUMENTS 

-read 

places the device in read-only mode. This control argument only applies if the 
device is a disk or a tape. 

-7track, -7tr 

specifies a 7-lrack tape drive. This argument only applies if the device is a tape. 

-priv 

specifies a privileged attachment (see "Device Attachment" below.) 

-sys 

sets the system_f lag in the rcp_ info structure during attachment (see "Device 
Attachment" below). 

-debug, -db 

runs the program in debug mode. In this mode, only the editing requests are 
recognized; no execution is allowed, and no actual device attachment takes place. 
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DEVICE ATTACHMENT 

The test_dew command attaches the device selected using the rcp_ subroutine. 
Normally, the call is made to rcp_$attach as a nonsystem process. However, if -priv is 
used, the call is made to rcp_priv_$attach. In both cases, if -sys is used, the 
system_flag in the rcp_ info structure is set, to indicate to rcp_ that you are to be 
considered a system process. You must have re access to the rcp_sys_ gate to make this 
kind of attachment. If the device specified in the command line is a device type rather 
than a specific device, rcp_ is relied upon to select the actual device to be used. In 
either case, the name of the device actually attached is printed after attachment 
completes. 

COMMANDS 



After the test_dcw command is invoked, commands are read from the user_input I/O 
switch. The following commands are recognized: 



tdcw 



idcw 



nidcw 



constructs a transfer DCW 



constructs an instruction DCW 



constructs a nondata transfer IDCW 



iotp 



constructs an I/O transfer and proceed DCW 



iotd 



constructs an I/O transfer and disconnect DCW 



iontp 



constructs an I/O transfer and proceed DCW 



odcw 



pew 



constructs a DCW from octal input 



constructs a PCW 



opcw 



constructs a PCW from octal input 



edit, e 

selects a DCW list to edit 

update, u 

places editor in "update" mode 
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insert, i 

places editor in "insert" mode 

delete, dl, d 

deletes a DCW from the list 

print, p 

prints a DCW list 

name 

names a DCW list so that it can be referenced by name instead of number 

save 

saves all the current DCW lists in a segment 

restore 

restores DCW lists from a segment created by the save command 

execute, x 

executes a DCW list 

getstat, g 

checks for status from a previous operation 

block, b 

blocks process until an event occurs 

xs 

executes a DCW list, but leaves process blocked until special interrupt occurs 

xr 

executes a DCW list repeatedly, until some unusual status is returned 

xre 

executes a DCW list repeatedly, regardless of whether the operations succeed or 
fail 

status, St 

sets the current status reporting mode 

rs 

reprints the status from a previous operation 

dump 

dumps data from the I/O buffer on terminal 

patch 

inserts data into the I/O buffer from terminal 
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pattern 

inserts data into the I/O buffer from the terminal by storing repeated copies of 
the data given 

survey 

displays data returned by a "survey devices" tape controller command 

dtstat 

displays data returned by a "read detailed status" tape handler command 

Chan 

selects a specific lOM and channel for I/O 

time 

sets or prints the current time limit for ioi timeout 

prompt 

stores a character string to be used as a prompting message 



susp 

rel 
•7 



suspends I/O on devices connected to an MPC by calling ioi_$suspend_devices 
restores I/O on devices connected to an MPC by calling ioi_$release_devices 



types out the current DCW list number, current DCW number, and the current 
editor mode 



types the word "test_dcw" to verify that the test_dcw command is still in 
control 

quit, q 

releases attached device and returns 

no BUFFER AREA 

Once the device is attached, an I/O buffer is allocated using the ioi_ subroutine. The 
default length is 1024 words, although this can be changed later. The first 32 words of 
the buffer are reserved for DCW lists, and the second 32 words are reserved for the 
ioi_ status queue. When constructing a DCW list, care should be taken to avoid 
modifying the first 64 words (100 octal) of the buffer, or results (especially status 
reporting) may be unpredictable. 
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DC\N LIST PREPARATION 

The test_dcw command contains an editor that can create and update DCW lists using 
simple input statements. Up to 32 different DCW lists, each up to 32 words in length, 
can be created and selectively updated and executed. Each DCW list also has a PCW 
associated with it that, if present, is used instead of the system-supplied PCW when the 
list is executed. The 32 DCW lists are numbered from 1 to 32 in decimal. Each DCW 
list can also be given a name. The 32 DCWs in each list are numbered from to 37 
in octal. 

The DCW editor keeps track of several quantities as DCWs are entered. These are the 
current list, the current DCW number, and the current mode. When the test_dcw 
command is invoked, the current list is 1, the current DCW is 0, and the mode is 
update. 

When a DCW is entered in update mode, the new DCW replaces the current DCW in 
the current list, and the current UQSN number is increased by one. 

The editor can also be placed in insert mode. In this mode, when a new DCW is 
entered, all DCWs starting with the current DCW are shifted one position down the 
list, the new DCW replaces the position formerly occupied by the old current DCW, 
and the current DCW is increased by one. DCWs shifted out of position 37 octal are 
lost. 

The edit command can be used to select a DCW list to edit, as follows: 

edit {list} {name} 
where: 

1. list 

is either the name or number of the DCW list to edit. The list can also be 
specified as "*", in which case, the first available empty list is used. 

2. name 

is the name given to the DCW list selected by the first argument. If 
omitted, the name of the list is not changed. 

This command sets the current list to the one specified, the current DCW to 0, and the 
mode to update. If the list argument is omitted, the current hst is not changed, but 
the current DCW and mode are set to and update respectively. 
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A DC!W list can be given a name (or a new name) with the name command. 

name {name! 

where: 

1. name 

is the name to be placed on the current list. If omitted, the current list ' 
becomes unnamed. If some other list has the name specified, that list 
becomes unnamed. 

The mode of the editor is controlled by the insert and update commands, as follows: 

update {n} 
insert {n} 

where: 

1. n 

is a DCW number, in octal. The update command puts the editor in update 
mode and sets the current DCW to n. Similarly, the insert command places 
the editor in insert mode. If n is omitted, the current DCW is not changed. 

A DCW can be deleted from the middle of the list with the delete command. 

delete {n} 

where: 

1. n 

is a DCW number, in octal. DCW n is deleted by moving everything after it 
in the list up one position. If n is omitted, the current DCW is deleted. The 
current DCW number is not changed. 

Any of the following commands can be used to create a E>CW: 

idcw 

nidcw 

tdcw 

iotd 

iotp 

iontp 

odcw 

After a DCW is constructed with any of these commands, it is edited into the current 
list, in the current position, according to the current mode, as described above. In all 
of the DCW commands described below, all numeric quantities are entered in octal. 
Any of the parameters shown are optional, and if omitted, the corresponding DCW 
field is zero (except for the device address field that is set to the address of the device 
assigned). 
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To create an IDCW, the command is entered as follows: 

idcw {di} {args} 
where: 

1. di 

is the value to be placed in the device instruction field. 

2. args 

are used to set the remaining fields in the IDCW and can be selected from 
the following: 

da oo 

places the value oo in the device address field. 

ci oo 

places the value oo in the channel instruction field. 

ae oo 

places the value oo in the address extension field. 

t oo 

places the value oo in the tally field. 

ec 

sets the extension control bit (ec bit). 

cont 

sets the continue bit. 

mark 

sets the marker status bit. 

A nondata transfer IDCW can be entered more easily using the nidcw command. It is 
identical in format to the idcw command, but the tally defaults to 01 and the channel 
instruction defaults to 02. 

A transfer DCW is created as follows: 

tdcv/ {addr} {args} 

where: 

1. addr 

is the value to be placed in the address field. 

2. args 

are used to set the remaining bits in the TDCW and can be selected from 
the following: 
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ec 

sets the extension change bit (ec). 

res 

sets the restricted bit 

rel 

sets the relative mode bit. 

lOTD, IOTP, and lONTP DCWs can be entered using the commands shown below. 

iotd {addr} {tally} {cp} 
iotp {addr] {tally} {cp} 
iontp {addr} {taily} {cp} 

where: 

1. addr 

is the value to be placed in the address field. 

2. tally 

is the value to be placed in the tally field. 

3. cp 

is the value to be placed in the character position field. 

Any arbitrary DCW can be entered using the dew command. 

odcw {word} 

where: 

1. word 

is the octal DCW to be used. If word is omitted, an all-zero (and invalid) 
DCW is created. 

Each DCW list can have one PCW associated with it. The PCW can be entered with 
the following command: 

pew {di} {args} 

where: 

1. di 

is the value to be placed in the device instruction field. 
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2. args 

are any of the optional args listed under the idcw command, with the 
following additions: 

mask 

sets the mask bit. 

reset 

sets bits 21, 22, and 23 to form a reset PCW. 

Any arbitrary PCW can be entered with the opcw command as follows: 

opcw {word} 

where: 

1. word 

is the octal PCW to be used. If word is omitted, an all-zero PCW is created 
and the system-supplied PCW is used on subsequent executions of the DCW 
list. 

The DCW list can be displayed at any time using the print command. 

print {list} 

where: 



list 



is either the name or number of a DCW list. If list is omitted, the current 
list is displayed. If list is specified, the current list is set to that list, the 
current DCW is set to 0, and the mode is set to update. Instead of a list 
name, "all" can be used to indicate that all DCW lists are to be displayed, or 
"names" can be used to list the names of all DCW lists. 

SAVING DCW LISTS 

Once edited, a permanent copy of all the current DCW lists can be saved in a segment 
for later use by invoking the save command. 

save path 

where: 

1. path 

is the pathname of the segment where the data is to be saved. The segment 
always has a suffix of "test_dcw", which is supplied automatically. 
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To restore the previously saved DCW lists, 

restore path 

where: 

1. path 

is the name of the segment created by the save command. If the command 
was not invoked in debug mode, all IDCWs and PCWs are updated with the 
device address of the device currently assigned. 

110 BUFFER EDITING 

Several commands are available to edit and display the contents of the I/O buffer. To 
enter data into the buffer, the patch command is used. 

patch offset wordl...word2...wordi 

where: 

1. offset 

is the octal offset in the buffer to be patched. 

2. wordi 

is the value to be placed in word offset+i. 

Offsets less than 100 octal should not normally be used, as this could interfere with the 
DCW list, or the status queue. 

If a repeating pattern is desired, use the pattern command. 

pattern offset repeats wordl...word2... wordi 

where: 

1. offset 

is the octal offset in the buffer where the data is to start. 

2. repeats 

is an octal number representing the number of times the data is to be 
repeated. 

3. wordi 

are the data words to be repeated. 
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To display the contents of a buffer (in octal), use the dump command. 

dump {offset} {length} 
where: 

1. offset 

is the offset in the buffer to be dumped. If omitted, 100 octal is assumed. 

2. length 

is the number of words to dump, in octal. If omitted, 10 octal is assumed. 

If the data consists of 8-bit bytes in binary mode (unaligned. 9 in each two words), the 
dump command can be used to dump them. The format is the same as the dump 
command, except that the data is displayed in binary, and the length is given in bytes, 
instead of words. 

If the data to be displayed is the output of a survey devices command issued to a tape 
controller, a special command can be used to display the data in a more meaningful 
way. 

survey {offset} 

where: 

1. offset 

is the location in the I/O buffer where the data has been stored. If the 
offset is omitted, 100 octal is assumed. 

If the data to be displayed consists of the output of a read detailed status command 
issued to a tape handler, it can be displayed with 

dtstat {offset} 

where: 

1. offset 

is the location in the buffer where the status has been stored. If omitted. 
100 octal is used. 
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EXECUTING THE DCW LIST 

Once the DCW list is constructed, it can be executed as follows: 

execute {list} 

where: 

1. list 

is the name or number of the DCW list to execute. If omitted, the current 
list is executed. If specified, the current list is changed to that list, the 
current DCW is set to 0, and the mode is set to update. The current list is 
copied into the I/O buffer starting at 0, and ioi_$connect is called to 
connect to relative address 0. If the list executed has a PCW associated with 
it, a call is made to ioi_$connect_pcw instead. After the connect is made, 
the process becomes blocked until an interrupt occurs. The status of the 
interrupt is then printed. If the status indicates that the channel is still 
running, the process goes blocked again waiting for another interrupt. If the 
channel is not running, test_dcw is ready to accept another command after 
the status is displayed. 

If the DCW list being executed generates a terminate interrupt and a special interrupt 
(such as loading a tape drive), the following command can be useful: 

xs {list} 

This command is identical to the execute command, except that the process goes 
blocked after displaying the status from each interrupt until a special interrupt occurs. 

A DCW list can be executed repeatedly using the following command: 

xr {list} 

This command executes the DCW list specified without displaying any status until an 
error condition is detected. The final status is printed normally. 

Another variation of this can be used when it is necessary to repeat the DCW list, even 
though it has errors. 

xre {list} 

executes the list specified repeatedly regardless of the status. To terminate this, it is 
necessary to quit and to use the Multics program_interrupt command, afterwards. 

Two other commands are occasionally useful in executing a DCW list. 

block, b 
getstat. g 



2-118 AR97-03 



test_dcw test dew 



The block command causes the process to go blocked waiting for an interrupt to occur. 
When it occurs, the resulting status is printed and test_dcw is ready for another 
command. The getstat command checks to see if any status is available, and prints it if 
it has occurred. The getstat command does not cause the program to go blocked if no 
status is available. 

Using the block command (or if a channel fails), it is possible to put the process in a 
state where it is waiting for an event that never occurs. If this happens, a quit 
followed by a Multics program_interrupt command can be used to return to the 
test_dcw input routine. 

STATUS REPORTING 

Status is normally reported when received by printing it on the terminal. Status can be 
reported in three modes, as follows: 

1. brief, bf 

is the default mode. The status message consists of the interrupt level in 
decimal, two words of lOM status in octal, and the major and minor status 
fields in binary. 

2. long, Ig 

consists of all eight words of the ioi_ status queue entry, in octal. 

3. edited, ed 

is an English-language interpretation of the status. 

The status mode is initially set to brief, but this can be changed as follows: 

status {mode} 

where: 

1. mode 

is one of the three status modes described above. If omitted, the current 
mode is printed. 

The previous status can also be redisplayed using the reprint status command. 

rs {mode} 

where: 

1. mode 

is one of the three modes described above. If omitted, edited mode is 
assumed. 
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OTHER COMMANDS 

Several other commands exist that can be useful. To set the length of the ioi_ timeout 
interval, use the time command. 

time {n} 

where: 

1. n 

is the time limit in decimal seconds. If n is omitted, the command prints the 
current limit. 

To change the size of the I/O buffer, 

work {n} 

where: 

1. n 

is the buffer length desired in decimal words. If n is omitted, the work 
command displays the current buffer length. 

To select a specific lOM and channel for I/O, the chan command can be used. 

Chan {iom} {channel} 

where: 

1. channel 

is the IOM channel, in octal. 

2. iom 

is the IOM selected. 

If channel is specified, but IOM is omitted, the IOM is as.sumed to be 1. If both are 
omitted, both are set to 0. indicating that ioi_ should make its own selection. The 
test_dcw command must be invoked with the -priv control argument in order to use 
this feature. 

To suspend I/O on devices to connect to an MPC, 

SUSP 

To restore I/O, use 
rel 
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These commands call the appropriate ioi_ entry points to accomplish their task. They 
are valid only if test_dcw was invoked with the -priv control argument and the device 
is connected to an MPC. 

To read the special device status stored by the previous operation, 

get_special_status 
To read the detailed device status stored by the previous operation, use 

get_detail_status 

If a prompt message is desired when test_dcw is ready for input, it can be supplied by 
you as follows: 

prompt {chars} 

where: 

1. chars 

is the data to be used for prompting. If chars is omitted, no prompt message 
is used. 

To exit from the iest_dcw command, 

quit, q 

The I/O device currently attached is detached, and the program terminates. 



Name: test ^fnp 

SYNTAX AS A COMMAND 

test_fnp FNP_tag {-control_args} 

FUNCTION 

tests DN66XX FNPs with the FED-supplied FNP test programs. 

ARGUMENTS 

FNP_tag 

is the tag of the FNP to be tested. This FNP must have been shut down or 
FDUMPed; it cannot be involved in testing by another process. Level 6 FNPs 
cannot be tested with this command. 
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CONTROL ARGUMENTS 

-exec name 

specifies the FNP executive to be run initially. The name can be either "BOS" or 
"lOS." The default is BOS. 

-input_switch name, -isw name 

specifies the I/O switch from which operator input is read. The default switch is 
user_input. 

-message_switch name, -msw name 

specifies the I/O switch to which messages intended for the T&D line printer are 
written. The default switch is user_output. The FNP T&D programs generate 
output of this form if its query "IS A PRINTER AVAILABLE?" is answered 
affirmatively. 

-output_switch name, -osw name 

specifies the I/O switch to which messages intended for the operator console are 
written. The default switch is user_output. 

NOTES 

The FNP type of the FNP selected for testing is obtained from information contained 
in the Channel Definition Table (>system_control_l>cdt). If the user does not have 
access to this data base, a user query is issued in the form: 

TEST_FNP: What is the FNP Type of FNP TAG? 
Anwser: DN6600, DN6670, DN355, or quit. 

If the "quit" response in entered, control is returned to the current command processor. 

Users should be familiar with the FED offline version of TST3BT. The test options, 
queries, and message diagnostics relevant to FNP testing are produced by the FNP test 
programs themselves. The documentation for the offline version of TST3BT running 
under the PAS2 EXEC, and the T&D documentation for the FNP tests, contain 
information on actual dialogue with this program; it is the same as the dialogue with 
the offline version. 

The operator console of TST3BT is simulated by the Multics terminal controlling the 
process running test_fnp. By default, test output appears on the terminal, and responses 
are expected from the terminal. Normal Multics input line editing applies to all 
responses, and lowercase input is acceptable. 

The response "quit" to any query of test_fnp, regardless of how it was generated, 
terminates the test session, releases the FNP, and returns to command level. 

The REQUEST button of the operator console is simulated by striking the QUIT key 
and using the program_interrupt (pi) command to return to test_fnp. Normally, the 
REQUEST button causes an interrupt to be sent to the FNP directing the FNP 
executive to enter its request loop. 
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Access to the tandd_ gate is required. Access to >scl>cdt is required to obtain 
the correct model number of the FNP. If you do not have access to the CDT, the 
default model number is DN6678. 

The tests executed by test_fnp are sorted in the keyed sequential vfile_ 
>system_library_tandd>tandd_deck_file. These tests are loaded from the FE distributed 
"FNP binary deck tapes" by the load_tandd_library command (described in Multics 
Online T&D). 



Name: test tape 

SYNTAX AS A COMMAND 

test_tape {-control_args} 

FUNCTION 

tests a tape drive or tape reel. 

CONTROL ARGUMENTS 

-volume ID, -vol ID 

specifies a tape by its volume identification number, which can have a maximum of 
nine characters. If -volume is not given, a default of "tesi_tape" is used. 

-comment STR, -com STR 

allows you to pass additional information about the requested volume mount to the 
operator. 

-device STR, -dv STR 

selects a specific tape unit; STR must be the complete device name. If this control 
argument is not given, the system finds a free tape unit (e.g., -device tapb_08). It 
is incompatible with -compare. 

-compare STR, -comp STR 

writes and then reads a tape on device STRl, and then automatically has the 
operator mount the tape on device STR2 and read the tape. The mounting and 
reading continues to device STRn. At least two devices must be specified. Only 
one device is attached at a time. The full device name (e.g., -comp tapa_05 
tapa_07) must be used. This control argument cannot be used with -device. 

-density N, -den N 

indicates the tape density, where N can be either 6250, 1600, or 800. The default 
is 1600. 

-track?, -tk7 

specifies a 7-track tape drive as the test unit. The default is 9 track. 
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-wait N, -wt N 

attempts to attach the device N times, after one-minute waits, if the device desired 
is being used by another process. If after N waits the device still cannot be 
attached, the program bypasses the device. The default for N is two times. 

-count N, -ct N 

indicates the number of records to be written or read, where N is a decimal 
integer. Each write operation creates one 1040 word physical record. If this 
control argument is not given, then the entire tape is written or read. 

-no_data_compare. -ndc 

disables comparison of the data read to a known pattern. This control argument is 
useful for verifying that a tape can be read without knowing what data is on the 
tape. 

-random 

fills the data buffers with a known random data pattern. It cannot be used with 
-pattern. 

-pattern N, -ptrn N 

specifies N as the word of octal data to fill the data buffers, where N can be a 
maximum of 12 octal digits. If fewer than 12 digits are given, the field is padded 
on the left with zeroes. If this control argument is not given, a pattern of 
222222222222 is used. The -pattern control argument cannot be used with -random. 

-write_read, -wr 

identifies the mode of the test. The tape is written and the read pass is 
preformed. (Default) 

-write, -w 

identifies the mode of the test. The tape is written and the read pass is bypassed. 

-read, -r 

identifies the mode of the test. The tape is mounted without a write ring and the 
read-only pass is preformed. 

-raw 

displays raw hex detailed status with each error message in addition to an 
interpreted display. 

NOTES 

The test_tape command senses the End of Tape Mark (EOT) and stops even if the 
record count has not been exhausted. Typing test_tape with no control arguments has 
the same effect as: 

test_tape -vol test-tape -den 1600 -ct 100000 -ptrn 222222222222 -wr 
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Listed below is a summary of the default control argument values. 



-volume 


(test-tape) 


-count 


(100000 {entire tape}) 


-comment 


(NONE) 


-ndc 


(OFF) 


-device 


(one previously assigned, 


-random 


(OFF) 




or a free device) 


-pattern 


(222222222222) 


-compare 


(OFF) 


-write 


(ON) 


-density 


(1600) 


-read 


(ON) 


-track 


(9) 


-raw 


(OFF) 


-wait 


(OFF) 
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SECTION 3 
MULTICS HEALS 



DESCRIPTION OF HEALS 



HEALS (Honeywell Error Analysis and Logging System) assists field engineering 
and operations personnel in monitoring the performance of the hardware and provides a 
record of hardware operation for diagnosing transient malfunctions, tracking performance 
of hardware modules, and predicting scheduled maintenance. 

HEAL SREPORTS 

HEALS reports are initiated by the heals_report command (described later in this 
section). The names of desired reports, the time period of the reports, and the 
pathname of the report file are specified by arguments to the command. The reports 
are 

io_error report 

all I/O errors logged to syserr log by the ioi_, disk_control, dn355, and 
bulk_store_control subroutine. The entries are in syserr log time sequence 
and contain the full octal status return word. 

sorted_io_error report 

the I/O errors of the io_error report orders by day and by device 
address (lOM number, channel number, and device number); grouping the 
errors for the convenience of maintenance personnel. Within a device 
address, entries are further ordered by power off, major status, sub 
status, initiate/ terminate interrupt, device command, lOM status, and 
record count residue. The octal status word is replaced (to keep the 
format width to 72 columns) by additional details of tape and disk 
errors. 
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cpu_error report 

history register data and other pertinent data for op_not_complete, 
parity, command, startup, and shutdown faults. 

mos_edac_error report 

the MOS EDAC error entries in syserr log. 

media_io_error report 

similar in content to the sorted_io_error report except that the primary 
sort key is media volume name (e.g., tape reel number). 

EXAMPLES OF REPORTS 

Examples of the HEALS reports that result from invocation of the heals_report 
command are shown on the following pages. The media_io_error report is not 
shown — its format and content are similar to the sorted_io._error report. If a problem 
is detected in processing an entry for the io_error report or the sorted_io_error report, 
the problem is reported with a comment line in place of data in the report entry. If 
the system is reconfigured between the time of logging an error and the time of 
execution of a HEALS run, reassigned channels or device names different from those 
obtained from the configuration table are not known to the report generators. These 
are reported as "ch_unkn" or "dv_unkn". The configuration known to HEALS is 
printed preceding an io_error or sorted_io_error report. If a device address cannot be 
determined, it is assigned lOM number and channel number so that the entries are 
grouped at the beginning of the sorted_io_error report. The numbers assigned 0,0 flag 
the entries as having invalid addresses. 

Each entry of a report contains the syserr log sequence number and log time so 
that entries can be cross-referenced to the original syserr log (see Sections 1 and 2) and 
the HEALS log, and between the io_error and sorted_io_error reports. 

Examples of the various HEALS reports follow. 
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Channel Assignment Table 

The configuration known to HEALS that is printed out prior to an io_error or 
sorted_io_error report is shown below. 



CHANNEL ASSIGNMENT TABLE AT TIME OF HEALS RUN 
RUN DATE: 08/15/77 RUN TIME: 1620.4, 

SYSTEM ID: MR6.0 SITE_ID: Honeywell 



lOM 


CHNL 


DEVICE 


MODEL 


NUM 


NUM 


NAME 


NUMBER 




08 


prtd 


1600 




09 


prta 


1200 




10 


rdra 


301 




11 


puna 


300 




12 


prtc 


301 




U 


rdrb 


201 




15 


punb 


201 




16 


ope 






17 


355a 






18 


tape 


500 




24 


dska 


451 




25 


dska 


451 




26 


dska 


451 




27 


dska 


451 




28 


dskb 


451 




29 


dskb 


451 




30 


dskb 


451 




31 


dskb 


451 
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IO_ERROR_REPORT: 08/11t/77 I619.8 TO 08/15/77 I6I9.8 PAGE 1 

SYSERR LOG DEVICE STATUS TLY TAPE NO STATUS RETURN 



TIME 


NUMBER 


NAME 


-CC-DD 


CM 


MJ-SB-I 




DISK_AD 




DATE: 08/1 if/77 














DATE: 08/14/77 


1725. i* 


34421 


rdra 


-10-01 


01 


02-01-t 


5 


N/A 


420140000000 


1809.8 


34427 


prtd 


-08-01 


34 


03-lO-t 


2 


N/A 


431000000000 


1809.9 


34429 


prtd 


-08-01 


34 


02-01-i 




N/A 


420102000000 


1822. i( 


34440 


prtd 


-08-01 


34 


03-04-t 




N/A 


430400000000 


]Bik.G 


34441 


prtd 


-08-01 


3^* 


02-01-i 




N/A 


420102000000 


1917.5 


34447 


tape 


-18-01 


15 


13-22-t 


5 


• 


532200000000 


1926.5 


34457 


tape 


-18-03 


15 


13-22-t 




mc019 


532200000000 


1939.5 


34458 


tape 


-18-03 


15 


13-22-t 




mc019 


532200000000 


1955.^ 


34482 


tape 


-18-04 


15 


13-22-t 




mc020 


532200000000 


2000.8 


34490 


tape 


-18-02 


15 


13-22-t 




mc021 


532200000000 


2006.7 


34491 


tape 


-18-02 


15 


13-22-t 




mc021 


532200000000 


2012.3 


34499 


tape 


-18-01 


15 


13-22-t 




mc022 


532200000000 


2017.7 


34504 


tape 


-18-03 


05 


12-10-t 




m2088 


521000000000 


2017.9 


34505 


tape 


-18-03 


05 


12-10-t 




m2088 


521000000000 


20l8./» 


34508 


tape 


-18-01 


15 


13-22-t 


2 


mc022 


532200000000 


2023.2 


34516 


tape 


-18-04 


15 


13-22-t 




mc023 


532200000000 


203it.l 


3't519 


tape 


-18-04 


15 


13-22-t 


7 


mc023 


532200000000 


2045.2 


3^527 


tape 


-18-02 


15 


13-22-t 




mc024 


532200000000 


20i»7.9 


34528 


tape 


-18-02 


15 


13-22-t 




mc024 


532200000000 


2053.7 


34536 


tape 


-18-03 


15 


13-22-t 




mc025 


532200000000 


2103.8 


34549 


tape 


-18-03 


15 


13-22-t 


3 


mc025 


532200000000 


2116.8 


34557 


tape 


-18-04 


15 


13-22-t 




mc026 


532200000000 


2120.8 


3'»57i 


tape 


-18-01 


15 


13-22-t 




mb025 


532200000000 


2208.2 


34582 


tape 


-18-03 


15 


03-10-t 




rn2068 


431000000000 


2357.9 


34586 


tape 


-18-01 


15 


13-22-t 


2 


mb025 


532200000000 


DATE: 08/15/77 














DATE: 08/15/77 


0700.3 


34610 


dska 


-26-02 


31 


02-20-t 


1 




422000000100 


0700.3 


34612 


dska 


-26-02 


31 






422456 




0700.3 


34614 


dska 


-26-02 


31 


extended: 


(40 


00 00 00 


82 00 00 00 00) 


0714.0 


34617 


tape 


-18-01 


15 


13-22-t 


2 


mb026 


532200000000 


0728.2 


34626 


tape 


-18-02 


15 


13-22-t 


1 


mb027 


532200000000 



END: 10 ERROR REPORT 
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SORTED_IO_ERROR_REPORT: 08/li*/77 I619.8 to 08/15/77 I619.8 PAGE 1 

DEVICE STATUS TLY TAPE_NO DENS RING TR< SYSERR LOG 

l-CC-DD NAME CM MJ-SB-I DISK AD CYL HEAD SEC TIME NUMBER 



DATE: 08/14/77 














DATE: 08/14/77 


1-08-01 


prtd 


34 


02-01-1 


1 


N/A 








1809.9 


34429 


1-08-01 


prtd 


34 


02-01-i 


1 


N/A 








1834.6 


34441 


1-08-01 


prtd 


34 


03-04-t 


1 


N/A 








1822.4 


34440 


1-08-01 


prtd 


34 


03-10-t 


2 


N/A 








1809.8 


34427 


end: prl 


td errors 


















1-10-01 


rdra 


01 


02-01-t 


5 


N/A 








1725.4 


34421 


end: rdr 


•a errors 


















1-18-01 


tape 


15 


13-22-t 


5 








• 


1917.5 


34447 


1-18-01 


tape 


15 


13-22-t 




mc022 


1600 


ys 


df 


2012.3 


34499 


1-18-01 


tape 


15 


13-22-t 


2 


mc022 


1600 


ys 


df 


2018.4 


34508 


1-18-01 


tape 


15 


13-22-t 




mb025 


1600 


ys 


df 


2120.8 


34571 


1-18-01 


tape 


15 


13-22-t 


2 


mb025 


1600 


ys 


df 


2357.9 


34586 


1-18-02 


tape 


15 


13-22-t 




mc021 


1600 


ys 


df 


2000.8 


34490 


1-18-02 


tape 


15 


13-22-t 




mc021 


1600 


ys 


df 


2006.7 


34491 


1-18-02 


tape 


15 


13-22-t 




mc024 


1600 


ys 


df 


2045.2 


3*4527 


1-18-02 


tape 


15 


13-22-t 




mc024 


1600 


ys 


df 


2047.9 


34528 


1-18-03 


tape 


15 


03-10-t 




m2068 


800 


ys 


df 


2208.2 


34582 


1-18-03 


tape 


05 


12-10-t 




m2088 


800 


ys 


9 


2017.7 


34504 


1-18-03 


tape 


05 


12-10-t 




m2088 


800 


ys 


9 


2017.9 


34505 


1-18-03 


tape 


15 


13-22-t 




mc019 


1600 


ys 


df 


1926.5 


34457 


1-18-03 


tape 


15 


13-22-t 




mcOig 


1600 


ys 


df 


1939.5 


34458 


1-18-03 


tape 


15 


13-22-t 




mc025 


1600 


ys 


df 


2053.7 


34536 


1-18-03 


tape 


15 


13-22-t 


3 


mc025 


1600 


ys 


df 


2103.8 


34549 


l-l8-0it 


tape 


15 


13-22-t 




mc020 


1600 


ys 


df 


1955.4 


34482 


l-l8-0it 


tape 


15 


13-22-t 




mc023 


1600 


ys 


df 


2023.2 


34516 


1-18-04 


tape 


15 


13-22-t 


7 


111CO23 


1600 


ys 


df 


2034.1 


34519 


1-18-04 


tape 


15 


13-22-t 


1 


mc026 


1600 


ys 


d<^ 


2116.8 


34557 


end: taj 


36 errors 


















DATE: 08/15/77 














DATE: 08/15/77 


1-18-01 


tape 


15 


13-22-t 


2 


mb026 


1600 


ys 


df 


0714.0 


34617 


1-18-02 


tape 


15 


13-22-t 


1 


mb027 


1600 


ys 


df 


0728.2 


34626 


end: taj 


3e errors 


















1-26-02 


dska 


31 


02-20-t 


1 










0700.3 


34610 


1-26-02 


dska 


31 






422456 


555 


16 


16 


0700.3 


34612 


1-26-02 


dska 


31 


extended: 


(40 


00 00 00 


82 00 


00 00 


00) 


0700.3 


34614 
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SORTED_IO_ERROR_REPORT (cont) 



DEVICE 




STATUS TLY 
MJ-SB-I [ 


TAPE_NO 
)ISK_AD ( 


DENS RING 
:YL HEAD i 


TRK 

;ec 


SYSERR 


LOG 


l-CC-DD 


NAME 


CM 


TIME 


NUMBER 


DATE: 08/13/77 












DATE: 08/13/77 


1-17-07 


tapa 


00 


02-04-i 1 










0902.7 


34690 


1-17-07 


tapa 


00 


02-04-i 1 










1013.6 


34929 


1-17-07 


tapa 


00 


02-04-i 1 










1046.3 


35044 


1-16-05 


tapa 


00 


03-lO-t 6 










0842.3 


34641 


1-16-05 


tapa 


00 


03-lO-t 1 










0842.6 


34643 


1-16-05 


tapa 


00 


03-10-t 3 










0844.6 


34645 


1-16-05 


tapa 


00 


03-40-t 3 










0847.7 


34647 


1-16-05 


tapa 


00 


03-40-t 1 










0847.8 


34650 


1-16-05 


tapa 


00 


03-40-t 1 










0847.8 


34652 


1-17-05 


tapa 


00 


03-lO-t 1 










0842.3 


34642 


1-17-05 


tapa 


00 


03-lO-t 1 










0843.5 


34644 


1-17-05 


tapa 


00 


03-40-t 1 










0847.7 


34649 


1-17-05 


tapa 


00 


03-40-t 1 










0847.8 


34651 


1-26-01 


dska 


00 


oo-03-t 1 C 


)001496 




18 


6 


1126.7 


35133 


1-26-01 


dska 


00 


oo-03-t 1 C 


)001507 




18 27 


1129.3 


35145 


1-28-11 


dskb 


34 


00-01-t 1 C 


)08l464 


07 


3 24 


1332.3 


35465 


1-26-07 


dska 


00 


00-20-t 1 C 


)120512 


58 


10 32 


0925.9 


34736 


1-26-07 


dska 


00 


00-02-t 1 C 


)121272 


59 


10 32 


0926.0 


34737 


1-24-07 


dska 


35 


oo-03-t 1 C 


)402248 i 


529 


5 08 


0954.2 


34843 


1-26-07 


dska 


00 


00-20-t 1 C 


)404640 f 


532 


8 00 


0954.1 


34841 


1-26-07 


dska 


35 


00-20-t 1 C 


)405400 f 


533 


8 00 


0954.2 


34842 


1-20-01 


dskc 


34 


00-20-t 1 C 


)444384 5 


584 


13 24 


1053.1 


35075 


1-20-01 


dskc 


00 


00-20-t 1 C 


)445144 f 


585 


13 24 


1053.0 


35074 


1-28-11 


dskb 


00 


00-20-t 1 C 


)592040 / 


ns 


00 


1331.8 


35464 


1-16-04 


tapa 


00 


03-lO-t 1 c 


ip012 c 


if It 


ys c 


if 


1355.3 


35516 


1-16-04 


tapa 


00 


03-10-t 5 c 


ip012 c 


if It 


ys df 


1358.5 


35522 


1-16-01 


tapa 


00 


03-40-t 11 c 


Ipl26 c 


iflt 


ys df 


0838.7 


34630 


1-16-03 


tapa 


00 


03-10-t 1 c 


ipl27 c 


if It 


ys df 


0839.6 


34640 


1-16-03 


tapa 


00 


03-lO-t 2 c 


ipl27 c 


iflt 


ys df 


0849.6 


34660 


1-16-03 


tapa 


00 


03-40-t 2 c 


Ipl27 c 


iflt 


ys df 


0849.6 


34663 



END: SORTED ID ERROR REPORT 
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CPU_ERROR_REPORT: 
HEALS RUN OF O8/I9/77 



from 08/12/77 1081.7 
1102.0 ON SYSTEM MR6.0 



to 08/12/77 1300.0 



CU Legend 

cy = cycle type (d = direct operand) 
(i = i nstr . f etch.o-operand, F=f aul t) 
(n=!indi rect,x=xec,>v=nop,e"=E IS) 
mc = memory command 
(00=rrs,sp; Oit=rrs,dp; 10-rcl,sp) 
(12=rmsk,sp; l6=rmsk,dp; 20=cwr,sp) 
(24=cwr,dp; 32=smsk,sp; 36=smsk,dp) 
(if0=rd/lck; S't^rgr; 56=sgr) 
(60=wrt/ulck; 62=con; 66=xec; 72=sxc) 
»>f lags<« 

-y = memory address invalid 
br = BAR mode 
cl = control unit load 
cs = control unit store 
dr = direct operand 
fa = prepare fault address 
ic = I C value is odd 
in = inhibited instruction 
ol = operations unit load 
OS - operations unit store 
pa = prepare operand address 
pb = port busy or data from cache 
pi = prepare instruction address 
pi = port select logic not busy 
pn = prepare final indirect address 
pt = prepare operand tally 
ra = request alter word 
ri = request indirect word 
rp = executing repeat 
sa = store alter word 
si = store indirect word 
tr " transfer condition met 
wi = request instruction fetch 
xa = prepare execute interrupt address 
xe = execute double from even I CT 
xi = execute interrupt present 
xo = execute double from odd I CT 



»fl 
9b = 
ar = 
dl = 
d2 - 
dl = 
du = 
i n = 
it = 
oa = 
oe = 
of = 
om = 
on = 

OS = 
qr = 
rb = 
rp = 
rs = 
sd = 
-d = 
xO = 
xl = 
x2 = 

x3 = 
xi. = 

x5 = 
x6 - 

x7 = 



_0U Legend_ 



ags«< 
9-bit byte (IT modifier only) 
A-register in use 
f i rst divide cycle 
second divide cycle 
direct lower operand 
direct upper operand 
first ou cycle 
IT character modifier 
mantissa alignment cycle 
exponent compare cycle 
final OU cycle 
general OU cycle 
normal ize cycle 
second cycle of multiple ops 
Q-register in use 
opcode buffer loaded 
primary register loaded 
secondary register loaded 
store data available 
data not aval lable 



i ndex 
i ndex 
index 
index 
i ndex 
i ndex 
index 
index 



I n 
i n 
i n 
i n 
in 
i n 
i n 
i n 



use 
use 
use 
use 
use 
use 
use 
use 
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_DU Legend_ 



mc = data mode (b,it,6,9.w) 
offset = descriptor counter 
>»f 1ags«< 
a = prepare alignment count for 

numeric operand (1,2) 
a = load alpha operand (1,2) 
al = adjust length 
as = alpha store 
bd = binary-decimal execution 



APU Legend 

seg# = SDWAMR and PTWAMR numbers if 
corresponding MATCH bits are set. 
offset = final store address 
mc = ring number (TSR.TRR) 



bg 
cO 
eg 
d() 
da = 
db = 
dd = 
di = 
dl = 
ds = 
ei = 
en = 
es = 
ff = 
fl = 
fp = 
fs = 
K) 
Id ■■ 
If ■■ 
Iv ■■ 
Ix ' 
1< ' 
mp ' 
n() 
nd = 
ns = 
op = 
pc ■ 
pi = 

PP = 
rO 
re ' 
rf = 
rl ■ 



blanking gate 
force stcO 
character operation 
= descriptor active (1,2,3) 
data aval lable 
decimal-binary execution 
decimal unit idle 
decimal unit interrupted 
decimal unit load 
decimal unit store 
mid-instruction interrupt enabl 
end instruction 

■ end sequence 

• floating result 

• first data buffer load 

■ first pointer preparation 
■■ end sequence 
= load descriptor (1,2,3) 
' length = direct 

■ end first poi nter. preparation 

■ level < word size 
length exhaust 
length < 128 
executing MOPs 

« load numeric operand (1,2) 

need descriptor 

numeric store 

operand aval lable 

alpha pacl<ing cycle 

prepare operand length 

prepare operand pointer 
= load rewrite register (1,2) 

write-back partial word 

rounding 

rewrite register 1 loaded 



»>f lags«< 


an = 


final address, nonpaged 


ap = 


final address, paged 


f = 


access violation or directed 




fault 


fd = 


fetch descriptor segment PTW 


fh = 


fault waiting 


fs = 


fetch SDW 


md = 


modify descriptor segment PTW 


mp = 


modify PTW 


pi = 


fetch PTW 


p2 = 


fetch PTW+1 


pm = 


MATCH in PTWAM 


sm = 


MATCH in SDWAM 



ed 
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CPU_ERROR_REPORT (cont) 

rw = du=rd+wt control interlock 

sa " select address register 

sg = shift procedure 

xg = exponent network 

xm = extended al.ql modifier 

+g - add-subtract execution 

*g = mul ti ply-divide execution 



syserr sequence #33228, at 08/12/77 1238.7; 
syserr_log text: op_not_complete fault on CPU B by 
Initial izer .SysDaemon.z. 



scu_data: 

pointer registers; 

index registers: 



000033570041 000000000027 400326000120 000000000000 
000230000200 342000000005 000006757120 000006757120 



61 
15 



5070 61 
137^ 15 



5120 33 
1374 61 



446 6l|4720 
4720 61 10 



003126 005070 001260 000000 
000002 000030 000241 000200 



a: 000000002000 q: 000446000000 exp: 000 timer: OOO331342 ring_alarm: 

000400000000 000400000000 004620252000 771077777707 
000000002000 000077777670 004576002004 000077777734 



ei s i nf o: 



fault register; 



010400000000 



NUM OU registers 

1 627000627100 

2 213000213100 

3 450000450300 

4 736000236340 

5 736000736100 

6 621000621100 

7 431210431100 

10 275210275500 

11 757000757300 

12 740000740300 

13 213000213100 

14 735000235340 

15 735000735100 

16 035000035500 

17 735000735100 
20 413000735240 



137767003101 

123777013505 
177777013522 
113777003107 
133777003110 
136777003122 

123777003123 
127777010221 
177777010222 
175777010223 
123777012172 
107777000224 
127777000225 
127777000226 
127777000227 
023777000230 



CU registers 
200107764000 
201037710100 
201137710000 
300007235120 
200007235000 
600137735000 
200127735000 
300007035120 
200007035000 
600137735000 
200127735000 
300007413120 
200007413005 
700137757120 
300127757120 
300125757120 



000033050020 

000447050200 

000224050200 

005072050020 

004145042011 

000226042201 

000007050015 

005074050020 

000050042011 

000230050201 

000003050015 

001464050021 

002000550010 

000232044201 

005076050021 

005076050002 
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DU registers 
777757037717 
737757037737 
737757037737 
777757037737 
737757037717 
777757037737 
737757037737 

777757037717 
737757037737 

777757037737 
737757037717 
777757037737 
737757037737 
737757037737 



IC 



1 

2 

3 
It 

5 
6 

7 
10 

n 
12 

13 
lit 

15 
16 

17 
20 

HR 
icl## 

CU 1 
CU 2 
CU 3 
CU it 
CU 5 
OUlit 
CU 6 
AU 1 
CU 7 
OUI5 
CUIO 
CUll 
OUI6 
CU12 
AU 2 
CUI3 
0U17 
CUlit 
CUI5 
CUI6 
AU 3 
AU it 

CUI7 
CU20 
0U20 



END: CPU ERROR REPORT 



7it^2it3'tl0017 
74it2it3^10017 
7i,i,2it3itl0017 
7ifit2it3itl0017 
7iti,2it3ifl0017 
7iti,2it3i»i0017 
7itit2it3itlooi7 
7i,i»2it34l0017 
7iii42it3itlO017 
7itit2it3itl0017 
7itit2it3itl0017 
74it2it3itl0017 
7Ait2it3itl0017 
7i,i,2it3iti0017 
7/ti*2it3itlOOl7 
74it2it3itl0017 



AU regist 
0006lit006lit4 
000336012000 
000336001020 
0006 12006 lit it 
0001itit006it50 
000336012000 
000336001020 
000153000000 
000152201000 
000152011000 
000715000000 
0007 lit20 1100 
OitOOitOOitOOitO 
Oit00400itOOitO 
00022i|itOOOit3 
O777774oooit3 



02332 lit50775 
00liit5it60775 
00000 U70775 

0233317^0775 
005621500775 
oonit5500775 
00000 li»30775 
0017757^0775 
023521720775 
oooit036it0775 

0017757't0775 
023521620775 
OitOOitOOitOOitO 
OitOOitOOitOOitO 
006ititOOOOOOO 
000001000000 



oped tag_ y seg#_ offset mc flags 



Iprpit 

tra 
itit7 tra 
22it Ida n'V 



225 als 



226 ad la n^( 



227 als 



230 rscr n* 

al 

231 staq n* 






o 

i 
i 

n 
o 

i 61 

1 2 

d 33 

n 33 

o 33 



I 



33 



33 
33 
33 



33 

itit7 

22it 

5072 

itlitS 

226 

23321it5 

7 

507it 
50 



230 

Ilit5it6 

33 3 



lit6it 

2000 

232 

U7 

2 2333174 

14 5076 

lit 5076 



it pa ic -y cl 
it pa tr wi it 
it pa tr ic wi 
it pa ri -y it cl 
it pa -y ol pb 

rp rs in of ar 
it pi pa ic wi pb 
ap sm pm 
it pa ic wi -y ol dr pb 

rs of -d ar 
it pa r i -y it cl 
it pa -y ol pb 

rb rs of -d ar 
it pi pa ic wi pb 
an sm 
it pa ic wi -y ol dr pb 

rs of -d ar 
it pa ri -y it cl pb 
54 pa -y ol 
4 pi pa ri ic wi i t pb 


ap sm pm 

4 pa ri ic wi -y it cl pb 
4 pa ri ic wi -y fa it pi 

rp in -d ar qr 



3-10 



AR97-03 



MOS_EDAC ERROR_REPORT: from 08/01/77 IO59.5 to 08/07/77 1059. 5 
HEALS RUN OF 8/19/77 1059-7 ON SYSTEM MR6.0 

LAST ERROR TALLY ERROR SYSTEM CONTROLLER REGISTER 

LOG_NUM DATE TIME RATE 

/MIN 

21019 08/01/77 ii435-7 1 5.00 000000000000 51*21771*00001 

EDAC error on mem b store b. MOS, kk chip. Error: board M, chip A77 

21589 08/02/77 101*9.8 1 5.00 000000000000 51*21771*00001 

EDAC error on mem b store b. MOS, kk chip. Error: board M, chip A77 

2161*9 08/03/77 1709.8 1 5.00. 000000000000 51*21771*00001 

EDAC error on mem b store b. MOS, l*k chip, Error: board M, chip A77 

22193 o8/oi*/77 111*6.8 2 5.00 000000000000 51*21771*00001 

EDAC error on mem b store b. MOS, l*k chip, Error: board M, chip A77 

22273 o8/oi*/77 1256.8 2 5.00 000000000000 11*07371*00001 

EDAC error on mem b store a. MOS, kk chip, Error: board Q, chip A67 

22271* o8/oi*/77 1256.8 1 5.00 000000000000 51*21771*00001 

EDAC error on mem b store b. MOS, kk chip. Error: board M, chip A77 

221*28 08/0lt/77 11*1*1.8 1* 5.00 000000000000 11*07371*00001 
EDAC error on mem b store a. MOS, kk chip, Error: board Q, chip A67 

2251*9 o8/oi*/77 161*6.8 1* 5.00 000000000000 11*07371*00001 

EDAC error on mem b store a. MOS, 4k chip. Error: board Q, chip A67 

22661 o8/oi*/77 1951.8 2 5.00 000000000000 11*0737400001 

EDAC error on mem b store a. MOS, 4k chip, Error: board Q, chip A67 

2273008/05/77 0001.9 1 5.00 000000000000542177400001 
EDAC error on mem b store b. MOS, 4k chip, Error: board M, chip A77 

23343 08/05/77 1606.2 1 5.00 000000000000 340077400001 

EDAC error on mem b store a. MOS, 4k chip, Error: board R, chip A78 

23573 08/06/77 0412.3 1 5.00 000000000000 000137400001 

EDAC error on mem c store a. MOS, 4k chip. Error: board Q, chip AI7 

END: MOS EDAC ERROR REPORT 
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HEALS IMPLEMENTATION 

The functions of an error analysis and logging system are: 

1. Capturing and logging hardware data. 

2. Sorting and analyzing the data. 

3. Presenting the analyzed data in a series of reports. 

The logging function is performed by the syserr mechanism to syserr log as 
described in Section 1. The other functions are performed by the facilities described in 
this section. 

The syserr log contains a number of entries not needed for the HEALS reports, 
and the time interval of syserr log data is normally not as large as may be desired for 
HEALS error data analysis. Therefore, the syserr log entries of interest to HEALS are 
extracted from the syserr log and written to an independent segment named 
>system_control_l>heals_dir>heals_log (hereafter referred to as the HEALS log). 

The update_heals_log, truncate_heals_log, and print_heals_message commands are 
provided to manage the HEALS log. 

The heals_report command creates a report for the specified time intervals and 
appends it to the output file, which is created if none exists. The default pathname of 
the output file is heals_reports in the working directory. The HEALS log is not 
updated or otherwise changed by the heals_report command. If the latest syserr log 
entries are wanted in the reports, the heals_report command must be preceded by the 
update_heals log command. 

The segment heals_log and a control data segment (heals_log_info) are contained 
in the directory >system_control_l>heals_dir. Management of the HEALS log is 
expected to be done by field engineering personnel. 

HEALS USAGE 

HEALS is for use on both routine reporting of hardware errors and for specific 
reports on demand. 

All HEALS reports should be generated on a daily basis following a HEALS log 
update to maintain a continuous record of hardware errors and malfunctions. This 
HEALS activity should be triggered by a scheduled absentee process such as the 
administrative "crank." 



Any lime that specific reports are wanted for monitoring or diagnostic purposes, 
the heals_report command can be invoked at the terminal with the name of the specific 
report desired (e.g., heals_report!io_error). Similarly, updaie_heals_log can be invoked 
by a privileged user of HEALS. 
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HEALS INSTALLATION REQUIREMENTS 

The directory >system_control_l>heals_dir. created by asu.ec 
(system accounting startup), must exist. 

The heals_log segment is created by the first invocation of the update_heals_log 
command. 



HEALS COMMANDS 

The commands that can be invoked to produce the HEALS reports are described 
in the remainder of this section. Command descriptions are presented in alphabetical 
order. 
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heals_repori heals_report 

Name: heals report 

SYNTAX AS A COMMAND 

heals_report {report_names} {-control_args} 

FUNCTION 

produces reports of interest to site-support and field-engineering personnel. The reports 
are appended to a report file specified in the -output_file control argument or by 
default to the heals_reports segment in the working directory. The ASCII report 
segment can be displayed, perused by you on the terminal, or printed on a high-speed 
line printer. 

ARGUMENTS 

report_names 

can be one or more names from the following list (see -all below): 

io_error 

selects the I/O error report. 

sorted_io_error 

selects the sorted I/O error report. 

media_io_erroT 

is similar to the sorted io error report except that the primary sort key is the 
media volume name (e.g.. tape reel number). 

cpu_error 

selects the CPU error report, 

mos_edac_error 

selects the MOS EDAC error report. 

CONTROL ARGUMENTS 

-output_file path, -of path 

puts the report file in the file specified by path. 

-from DT. -fm DT 

specifies the date and time after which errors are reported. If this argument is not 
given, the default value is the value of -to time minus 24 hours. 

-to DT 

specifies the date and tim.e up to which errors are reported. If this argument is 
not given, the default value is the current date and time. 

-all -a 

specifies that all reports are to be generated. This argument can be used instead of 
listing all report names. 
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heals_repon prinl_heals_message 



NOTES 

The dates specified after the -fm, -from, and -to control arguments must be acceptable 
to convert_date_to_binary_ (see the Subroutines manual). 

You must have r access on >system_control_l>heals_dir>heals_log. 

EXAMPLES 

If the command line: 

heals_report io_error -from O3/OI/78 -to O3/02/78 

is issued at 2:00 PM; an ASCII report segment named heals_reports suitable for printing 
is created in the current working directory, containing the I/O Error Report for the 
period from 2:00 PM, March 1, 1978 to 2:00 PM, March 2, 1978. 



Name: print_heals message 

SYNTAX AS A COMMAND 
print_heals_message {-control_args} 
FUNCTION 

is a tool to be used by administrators for the maintenance of the HEALS log (the 
segment named >system_control_l>heals_dir>heals_log). It allows the printing of all or 
selected messages currently in the log. It can also be used to delete bad records from 
the log as well as to print out parts of each logged record. 

CONTROL ARGUMENTS 

-time DT 

selects all messages that occurred after the specified time. If omitted, a value of 
is assumed. 

-update 

allows you to delete selected messages from the HEALS log if you have the 
appropriate access. (See "Notes" below.) 

-match STR 

selects messages with text containing the match string. 

NOTES 

You must have rw access on >system_conirol_l>heals_dir>heals_log for the update 
function; otherwise, r access is sufficient. 
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print_heals_message truncate_heals_log 



The date/ time following the -time control argument must be of a form acceptable to 
convert_date_io_binary_ described in the Subroutines manual. 

The print_heals_message command opens the heals_log segment with a mode of 

keyed_sequential_update to allow messages to be deleted. If a message is selected by 

using either the -time or the -match control argument, you can issue the following 
requests: 

quit,q 

discontinues message processing and returns to command level. 

next 

selects the next message that meets the specified selection requirements. 

delete 

deletes the current record. 

data 

prints the octal data contained in the current record. 

EXAMPLES 

The command line: 

pr i nt_heal s_message -time OI/OI/78 -match ioi_i nterrupt 

sends to the user_output I/O switch all messages that were received after 01/01/78 
whose ASCII text contains the string "ioi_interrupt". 



Name: truncate heals log 

SYNTAX AS A COMMAND 

truncate_heals_1og N 

or 
truncate_heal s_lQg {-control_args} 

FUNCTION 

deletes records from >system_control_l>heals_dir>healsJog. It is used with the 
update_heals_log command. 

ARGUMENTS 

N 

is the number of days, counted back from the current time, for which messages 
are to remain in the HEALS log. 
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truncate_heals_log update_heals_log 



CONTROL ARGUMENTS 

-from DT, -fm DT 

starts deleting messages from the specified date/ time. If this control argument is 
omitted, a clock value of is assumed; that is, the truncate_heals_log command 
starts deleting messages from the beginning of the log. 

-to DT 

stops deleting messages from the specified date/ time. If omitted, a clock value 
equal to the current time is assumed. 

NOTES 

You must have rw access to the heals_log and heals_log_info segments, both located in 
>system_control_l>heals_dir, in order to delete messages from the HEALS log. 

The date/ times following the control arguments must be in a form acceptable to 
convert_date_to_binary_ (see the Subroutines manual). 



Name: update_heals_log 

SYNTAX AS A COMMAND 
update_hea 1 s_l og 
FUNCTION 

copies messages of interest to HEALS from the syserr log file into the HEALS log, 
The messages copied are those new messages added to the syserr log since the last 
invocation of this command by any process. 

NOTES 

In order to update the log, the directory >system_control_l>heals_dir must already exist 
and you must have access to system files as follows: 

re to audit._gate and to phcs_ 

r to system_contro]_l>perm_syserr_log 

rw to system_coniro]_l>heals_dir>heals_log 

rw to system_control_l>heals_dir>heals_log_info 

If either the segment >system_control_l>heals_dir>heals_log or the segment 
>system_controLl>heals_dir>heals_log_info does not exist, it is created: in this case you 
need sma access on >system_control_l>heals_dir. The heals_log_info segment contains 
information about the current heals_log segment. 
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iruncate_heals_log update_heals_log 



CONTROL ARGUMENTS 

-from DT, -fm DT 

starts deleting messages from the specified date/ time. If this control argument is 
omitted, a clock value of is assumed; that is, the truncate_heals_log command 
starts deleting messages from the beginning of the log. 

-to DT 

stops deleting messages from the specified date/ time. If omitted, a clock value 
equal to the current time is assumed. 

NOTES 

You must have rw access to the heals_log and heals_log„info segments, both located in 
>sysiem_control_l>heals_dir, in order to delete messages from the HEALS log. 

The date/ times following the control arguments must be in a form acceptable to 
convert_date_to_binary_ (see the Subroutines manual). 



Name: update_^heals log 

SYNTAX AS A COMMAND 

copies messages of interest to HEALS from the syserr log file into the HEALS log. 
The messages copied are those new messages added to the syserr log since the last 
invocation of this command by any process. 
update_heals_log 

NOTES 

In order to update the log, the directory >system_control_l>heals_dir must already exist, 
and you must have access to system files as follows: 

re to audit_gaie and to phcs_ 

r to sysiem_control_l>perm_syserr_log 

rw to system_control_l>heals_dir>heals_log 

rw to sysiem_conirol_l>heals_dir>heals_log_info 

If either the segment >system_control_l>heals_dir>heals_log or the segment 
>system_contro]_l>heals_dir>heals_log_info does not exist, it is created; in this case, you 
neied sma access on >sysiem_control_l>heals_dir. The heals_log_info segment contains 
information about the current heals_log segment. 
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INDEX 



ALM segment (etx) 
eis_tester 2-42 

analy2e_niul t i cs command 2-2 

AU 

see history registers 



CPU hardware problems 
check! ng 

test_cpu 2-102 

CPU usage 

1 i st_proc_requi red 2-75 

crash analysis 

anal yze_mul t i cs 2-2 



CU 



see history registers 



BOS 

dump analysis 

analyze_mul t i cs 2-2 



check_cpu_speed command 2-31 

CPU 

default set 

set_proc_requi red 2-100 
speed 

check_cpu_speed 2-31 



dal ly_syserr_process command 2-32 

DCW 1 ists 

test_dcw 2-107 

devi ce_meters command 2-36 

disk dr i ve 

exerc i se_d i sk 2-71 

disk subsystems 
i nf ormat ion 
devi ce_meters 2-36 

di spl ay_cpu_error command 2-38 
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di sp1ay_syserr_log_part command 2-39 

DN66XX FNPs 
testing 

test_fnp 2-121 



DU 

see history registers 

dump analysis 

ana lyze_mu1 tics 2-2 

dump_f i rmware command 2-40 

dump_mpc command 2-40 

dvm 

see device meters 



EDAC errors 

set_mos_po] 1 i ng_t ime 2-100 

EIS 2-80 

EIS instructions 
eis_tester 2-42 

eis_tester command 2-42 

et 

see eis_tester 

exerci se_di sk command 2-7 1 



FNPs (cont) 
FED 

test_fnp 2-121 
pol 1 i ng 

po11_fnp command 2-91 

pol1_mpc 2-93 

f np_data_summary command 2-72 



HEALS 3-1 

HEALS log 
mai ntenance 

pri nt_heals_message 3~15 

heal s_report command 3-14 

history registeres 
1 i sti ng 
mc_trace 2-77 

history registers 

Appending Unit (AU) 2-79 
Control Unit (CU) 2-79 
Decimal Unit (DU) 2-79 
Operations Unit (OU) 2-79 
processor 

save_hi story_regi sters 2-99 

Honeywell Error Analysis and Logging 
System (HEALS) 3"! 
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FCO number 

eis_tester 2-42 

FNPs 
DN66XX 

test_fnp 2-121 



I /O errors 
reporting 

i o_error_summary 2-73 

I/O interfacer 
test_dcw 2-107 

io_error_summary command 2-73 
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ITRs 2-76 



OU 



see history registers 



1 i st_proc_requi red command 2-75 
load_mpc command 2-76 



maciiine conditions 
1 i St i ng 

mc_trace 2-77 

maintenance register 
pol l_mos_memory 2-92 

met 

see mc_trace command 

mc_trace command 2-77 

meter ing 

i nformat ion 
devi ce_meters 2-36 

MOS memories 
pol 1 i ng 

set_mos_pol 1 i ng_time 2-100 

mos_edac_summary command 2-87 

MPC 2-76 
dumping 

dump_mpc 2-1+0 
pel 1 i ng 

pol l_mpc 2-93 

MPC firmware 

dump_f i rmware 2-itO 
patch_f i rmware 2-9O 

mpc_data_summary command 2-89 



page control devices 
metering information 
device_meters 2-36 

patch_f i rmware command 2-90 

pcd 

see pr i nt_conf i gurat ion_deck 

pol 1 i ng 

MOS memories 

set_mos_pol I i ng_t ime 2-100 

pol l_f np command 2-91 

pol l_mos_memory command 2-92 

pol l_mpc command 2-93 

pr i nt_conf i gurat ion_deck command 2-94 

pr i nt_heal s_message command 3" 15 

pr i nt_syserr_log command 2-96 

process 
1 i St i ng 

1 i st_proc_requi red 2-75 

processor 

history registers 

save_h i story_regi sters 2-99 
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reconfiguration commands 

pr int_conf igurat ion_decl< 2-9i| 

records 
delet i ng 

truncate_heal s_log 3" 16 



save_hi story_regi sters command 2-99 

SCU 

see System Control Unit 

set_mos_pol 1 ing_time command 2-100 

set_proc_required command 2-100 

signalers stack frame 
registers 

save_history_regi sters 2-99 

sprq 

see set_proc_ requi red command 

storage system salvager 
messages 1-1 

syserr log 
contents 1-1 
EDAC error 

pol l_mos_memory 2-92 
entr ies 

dai ly_syserr_process 2-32 
error handl i ng 

po]l_mpc 2-93 
history registers 

display_cpu_error 2-38 
logging partition 

di splay_syserr_log_part 2-39 
machine conditions 

d i splay_cpu_error 2-38 
mos edac activity 

mos_edac_summary 2-87 
MPC statistics 

mpc_data_summary 2-89 



syserr log (cont) 

pr i nti ng 

pr i nt_syserr_log 2-96 

processing 

dai ly_syserr_process 2-32 

scanni ng 

io_error_summary 2-73 
mpc_data_summary 2-89 

Stat i sties 

f np_data_summary command 2-72 
pol l_fnp command 2-91 
poll_mpc 2-93 
update_hea1s_log 3~17 

updating 

update_heal s_log 3-17 

System Control Unit 2-79 



tape drive testing 
test_tape 2-12^ 

tape reel testing 
test_tape 2-123 

test_cpu command 2-102 

test_dcw command 2-107 

test_fnp command 2-121 

test_tape command 2-123 

truncate_heals_log command 3-16 
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